Partager via


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
accountName
path True

string

minLength: 3
maxLength: 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 : http://accountname.region.batch.azure.com/.

certificateName
path True

string

minLength: 5
maxLength: 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.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Nom du groupe de ressources. Le nom ne respecte pas la casse.

subscriptionId
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

Certificate

La demande a réussi.

En-têtes

ETag: string

Other Status Codes

CloudError

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

GET https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/certificates/sha1-0a0e4f50d51beadeac1d35afc5116098e7902e6e?api-version=2024-07-01

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

GET https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/certificates/sha1-0a0e4f50d51beadeac1d35afc5116098e7902e6e?api-version=2024-07-01

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.

CertificateFormat

Format du certificat : Pfx ou Cer. S’il est omis, la valeur par défaut est Pfx.

CertificateProvisioningState
CloudError

Réponse d’erreur du service Batch.

CloudErrorBody

Réponse d’erreur du service Batch.

createdByType

Type d’identité qui a créé la ressource.

DeleteCertificateError

Réponse d’erreur du service Batch.

systemData

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

DeleteCertificateError

Erreur qui s’est produite lors de la suppression du certificat
Cela n’est retourné que lorsque l’état d’approvisionnement du certificat est « Échec ».

properties.format

CertificateFormat

Format du certificat : Pfx ou Cer. S’il est omis, la valeur par défaut est Pfx.

properties.previousProvisioningState

CertificateProvisioningState

É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

CertificateProvisioningState

É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.
Cela doit correspondre à l’empreinte numérique du nom.

properties.thumbprintAlgorithm

string

Algorithme de l’empreinte numérique du certificat.
Cela doit correspondre à la première partie du nom du certificat. Actuellement requis pour être « SHA1 ».

systemData

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

CloudErrorBody

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

CloudErrorBody[]

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

DeleteCertificateError[]

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

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

createdByType

Type d’identité qui a modifié la ressource pour la dernière fois.