Certificate - Get
Obtient des informations sur le certificat spécifié.
Avertissement : cette opération est déconseillée et sera supprimée après février 2024. Utilisez plutôt l''extension Azure KeyVault.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/certificates/{certificateName}?api-version=2024-07-01
Paramètres URI
| Nom | Dans | Obligatoire | Type | Description |
|---|---|---|---|---|
|
account
|
path | True |
string minLength: 3maxLength: 24 pattern: ^[a-zA-Z0-9]+$ |
Un nom pour le compte Batch qui doit être unique dans la région. Les noms de comptes des lots doivent mesurer entre 3 et 24 caractères et ne doivent utiliser que des chiffres et des lettres minuscules. Ce nom est utilisé comme partie intégrante du nom DNS utilisé pour accéder au service Batch dans la région où le compte est créé. Par exemple : |
|
certificate
|
path | True |
string minLength: 5maxLength: 45 pattern: ^[\w]+-[\w]+$ |
Identificateur du certificat. Il doit s’agir d’un algorithme et d’une empreinte numérique séparés par un tiret, et doit correspondre aux données de certificat dans la demande. Par exemple SHA1-a3d1c5. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nom du groupe de ressources. Le nom ne respecte pas la casse. |
|
subscription
|
path | True |
string (uuid) |
ID de l’abonnement cible. La valeur doit être un UUID. |
|
api-version
|
query | True |
string minLength: 1 |
Version de l’API à utiliser pour cette opération. |
Réponses
| Nom | Type | Description |
|---|---|---|
| 200 OK |
La demande a réussi. En-têtes ETag: string |
|
| Other Status Codes |
Réponse d’erreur inattendue. |
Sécurité
azure_auth
Flux OAuth2 Azure Active Directory.
Type:
oauth2
Flux:
implicit
URL d’autorisation:
https://login.microsoftonline.com/common/oauth2/authorize
Étendues
| Nom | Description |
|---|---|
| user_impersonation | emprunter l’identité de votre compte d’utilisateur |
Exemples
| Get Certificate |
| Get Certificate with Deletion Error |
Get Certificate
Exemple de requête
Exemple de réponse
ETag: W/"0x8D4EDD5118668F7"
{
"name": "sha1-0a0e4f50d51beadeac1d35afc5116098e7902e6e",
"type": "Microsoft.Batch/batchAccounts/certificates",
"id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/samplecct/certificates/sha1-0a0e4f50d51beadeac1d35afc5116098e7902e6e",
"properties": {
"format": "Pfx",
"provisioningState": "Succeeded",
"provisioningStateTransitionTime": "2017-07-21T01:47:38.4420202Z",
"publicData": "MIICrjCCAZagAwI...",
"thumbprint": "0a0e4f50d51beadeac1d35afc5116098e7902e6e",
"thumbprintAlgorithm": "sha1"
}
}
Get Certificate with Deletion Error
Exemple de requête
Exemple de réponse
ETag: W/"0x8D4EDD5118668F7"
{
"name": "sha1-0a0e4f50d51beadeac1d35afc5116098e7902e6e",
"type": "Microsoft.Batch/batchAccounts/certificates",
"id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/samplecct/certificates/sha1-0a0e4f50d51beadeac1d35afc5116098e7902e6e",
"properties": {
"format": "Pfx",
"deleteCertificateError": {
"code": "NodesReferencingCertificate",
"message": "The specified certificate is being used by the below mentioned node(s)\nRequestId:2dc78afc-b15b-42d2-8c85-39cb61a0799e\nTime:2017-08-28T10:22:52.8633406Z",
"target": "BatchAccount",
"details": [
{
"code": "Nodes",
"message": "node1, node3"
}
]
},
"previousProvisioningState": "Deleting",
"previousProvisioningStateTransitionTime": "2017-07-21T00:15:25.5625498Z",
"provisioningState": "Failed",
"provisioningStateTransitionTime": "2017-07-21T01:47:38.4420202Z",
"publicData": "MIICrjCCAZagAwI...",
"thumbprint": "0a0e4f50d51beadeac1d35afc5116098e7902e6e",
"thumbprintAlgorithm": "sha1"
}
}
Définitions
| Nom | Description |
|---|---|
| Certificate |
Contient des informations sur un certificat. |
|
Certificate |
Format du certificat : Pfx ou Cer. S’il est omis, la valeur par défaut est Pfx. |
|
Certificate |
|
|
Cloud |
Réponse d’erreur du service Batch. |
|
Cloud |
Réponse d’erreur du service Batch. |
|
created |
Type d’identité qui a créé la ressource. |
|
Delete |
Réponse d’erreur du service Batch. |
|
system |
Métadonnées relatives à la création et à la dernière modification de la ressource. |
Certificate
Contient des informations sur un certificat.
| Nom | Type | Description |
|---|---|---|
| etag |
string |
ETag de la ressource, utilisée pour les instructions d’accès concurrentiel. |
| id |
string (arm-id) |
ID de ressource complet pour la ressource. Par exemple, « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} » |
| name |
string |
Nom de la ressource |
| properties.deleteCertificateError |
Erreur qui s’est produite lors de la suppression du certificat |
|
| properties.format |
Format du certificat : Pfx ou Cer. S’il est omis, la valeur par défaut est Pfx. |
|
| properties.previousProvisioningState |
État provisionné précédent de la ressource |
|
| properties.previousProvisioningStateTransitionTime |
string (date-time) |
Heure à laquelle le certificat a entré son état précédent. |
| properties.provisioningState |
État provisionné de la ressource |
|
| properties.provisioningStateTransitionTime |
string (date-time) |
Heure à laquelle le certificat a entré son état actuel. |
| properties.publicData |
string |
Clé publique du certificat. |
| properties.thumbprint |
string |
Empreinte numérique du certificat. |
| properties.thumbprintAlgorithm |
string |
Algorithme de l’empreinte numérique du certificat. |
| systemData |
Métadonnées Azure Resource Manager contenant les informations createdBy et modifiedBy. |
|
| tags |
object |
Balises de la ressource. |
| type |
string |
Type de la ressource. Par exemple, « Microsoft.Compute/virtualMachines » ou « Microsoft.Storage/storageAccounts » |
CertificateFormat
Format du certificat : Pfx ou Cer. S’il est omis, la valeur par défaut est Pfx.
| Valeur | Description |
|---|---|
| Pfx |
Le certificat est un certificat ou une chaîne de certificats au format PFX (PKCS#12). |
| Cer |
Le certificat est un certificat X.509 codé en base64. |
CertificateProvisioningState
| Valeur | Description |
|---|---|
| Succeeded |
Le certificat est disponible pour une utilisation dans les pools. |
| Deleting |
L’utilisateur a demandé que le certificat soit supprimé, mais que l’opération de suppression n’a pas encore été terminée. Vous ne pouvez pas référencer le certificat lors de la création ou de la mise à jour de pools. |
| Failed |
L’utilisateur a demandé que le certificat soit supprimé, mais il existe des pools qui ont toujours des références au certificat, ou il est toujours installé sur un ou plusieurs nœuds de calcul. (Ce dernier peut se produire si le certificat a été supprimé du pool, mais que le nœud n’a pas encore redémarré. Les nœuds actualisent leurs certificats uniquement quand ils redémarrent.) Vous pouvez utiliser l’opération annuler la suppression de certificat pour annuler la suppression ou l’opération de suppression de certificat pour réessayer la suppression. |
CloudError
Réponse d’erreur du service Batch.
| Nom | Type | Description |
|---|---|---|
| error |
Corps de la réponse d’erreur. |
CloudErrorBody
Réponse d’erreur du service Batch.
| Nom | Type | Description |
|---|---|---|
| code |
string |
Identificateur de l’erreur. Les codes sont invariants et sont destinés à être consommés par programme. |
| details |
Liste des détails supplémentaires sur l’erreur. |
|
| message |
string |
Message décrivant l’erreur, destiné à être adapté à l’affichage dans une interface utilisateur. |
| target |
string |
Cible de l’erreur particulière. Par exemple, le nom de la propriété en erreur. |
createdByType
Type d’identité qui a créé la ressource.
| Valeur | Description |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
DeleteCertificateError
Réponse d’erreur du service Batch.
| Nom | Type | Description |
|---|---|---|
| code |
string |
Identificateur de l’erreur. Les codes sont invariants et sont destinés à être consommés par programme. |
| details |
Liste des détails supplémentaires sur l’erreur. |
|
| message |
string |
Message décrivant l’erreur, destiné à être adapté à l’affichage dans une interface utilisateur. |
| target |
string |
Cible de l’erreur particulière. Par exemple, le nom de la propriété en erreur. |
systemData
Métadonnées relatives à la création et à la dernière modification de la ressource.
| Nom | Type | Description |
|---|---|---|
| createdAt |
string (date-time) |
Horodatage de la création de ressources (UTC). |
| createdBy |
string |
Identité qui a créé la ressource. |
| createdByType |
Type d’identité qui a créé la ressource. |
|
| lastModifiedAt |
string (date-time) |
Horodatage de la dernière modification de ressource (UTC) |
| lastModifiedBy |
string |
Identité qui a modifié la ressource pour la dernière fois. |
| lastModifiedByType |
Type d’identité qui a modifié la ressource pour la dernière fois. |