Partager via


Certificate - List By Batch Account

Répertorie tous les certificats dans le compte 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?api-version=2024-07-01
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/certificates?api-version=2024-07-01&maxresults={maxresults}&$select={$select}&$filter={$filter}

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/.

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.

$filter
query

string

Expression de filtre OData. Les propriétés valides pour le filtrage sont « properties/provisioningState », « properties/provisioningStateTransitionTime », « name ».

$select
query

string

Liste séparée par des virgules des propriétés qui doivent être retournées. par exemple, « properties/provisioningState ». Seules les propriétés de niveau supérieur sous propriétés/sont valides pour la sélection.

maxresults
query

integer (int32)

Nombre maximal d’éléments à retourner dans la réponse.

Réponses

Nom Type Description
200 OK

ListCertificatesResult

L’opération Azure s’est terminée avec succès.

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

ListCertificates
ListCertificates - Filter and Select

ListCertificates

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?api-version=2024-07-01

Exemple de réponse

{
  "nextLink": "https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/samplecct/certificates?api-version=2024-07-01&$skiptoken=NPK%3D28%3A2857p428pug%2022F53A7734C947B8NRK%3D45%3Asha1-c23dc7f22edc793856a7506fe66397ccb4a33b46SM%3D5%3AFalse",
  "value": [
    {
      "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"
      }
    }
  ]
}

ListCertificates - Filter and Select

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?api-version=2024-07-01&$select=properties/format,properties/provisioningState&$filter=properties/provisioningStateTransitionTime gt '2017-05-01' or properties/provisioningState eq 'Failed'

Exemple de réponse

{
  "value": [
    {
      "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": "Failed"
      }
    },
    {
      "name": "sha1-aeb228ffb0bf67a793d61dce263ebd16949f15a1",
      "type": "Microsoft.Batch/batchAccounts/certificates",
      "id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/samplecct/certificates/sha1-aeb228ffb0bf67a793d61dce263ebd16949f15a1",
      "properties": {
        "format": "Cer",
        "provisioningState": "Failed"
      }
    }
  ]
}

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.

ListCertificatesResult

Valeurs retournées par l’opération Liste.

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.

ListCertificatesResult

Valeurs retournées par l’opération Liste.

Nom Type Description
nextLink

string (uri)

Le lien vers la page suivante des éléments

value

Certificate[]

Les éléments du certificat sur cette page

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.