7.9.10 GetCertificateStatus
The GetCertificateStatus Method is used to check if an application has to update its Certificate.
If this Method is called for a CertificateGroup which the application does not belong to then the Method shall return UpdateRequired=TRUE.
This Method shall be called from an authenticated SecureChannel and from a Client that has access to the CertificateAuthorityAdmin Role, the ApplicationAdmin Privilege, or the ApplicationSelfAdmin Privilege (see 7.2).
Signature
GetCertificateStatus(
[in] NodeId ApplicationId
[in] NodeId CertificateGroupId
[in] NodeId CertificateTypeId
[out] Boolean UpdateRequired
);| Argument | Description |
| ApplicationId | The identifier assigned to the applicationby the GDS. |
| CertificateGroupId | The NodeId of the CertificateGroup which provides the context. If null the CertificateManager shall choose the DefaultApplicationGroup. |
| CertificateTypeId | The NodeId of the CertificateType for the Certificate. If null the CertificateManager shall select a Certificate based on the value of the CertificateGroupId argument. |
| UpdateRequired | TRUE if the application has to request a new Certificate from the GDS. FALSE if the application can keep using the existing Certificate. |
Method Result Codes (defined in Call Service)
| Result Code | Description |
| Bad_NotFound | The ApplicationId does not refer to a registered application. |
| Bad_InvalidArgument | The CertificateGroupId or CertificateTypeId parameter is not valid. The text associated with the error shall indicate the exact problem. |
| Bad_UserAccessDenied | The current user does not have the rights required. |
| Bad_SecurityModeInsufficient | The SecureChannel is not authenticated. |
Table 82 specifies the AddressSpace representation for the GetCertificateStatus Method.
| Attribute | Value | ||||
| BrowseName | 2:GetCertificateStatus | ||||
| References | NodeClass | BrowseName | DataType | TypeDefinition | ModellingRule |
|---|---|---|---|---|---|
| 0:HasProperty | Variable | 0:InputArguments | 0:Argument[] | 0:PropertyType | Mandatory |
| 0:HasProperty | Variable | 0:OutputArguments | 0:Argument[] | 0:PropertyType | Mandatory |