Certificate - Get
Obtiene información sobre el certificado especificado.
Advertencia: esta operación está en desuso y se quitará después de febrero de 2024. Use el de extensión de Azure KeyVault de
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/certificates/{certificateName}?api-version=2024-07-01
Parámetros de identificador URI
| Nombre | En | Requerido | Tipo | Description |
|---|---|---|---|---|
|
account
|
path | True |
string minLength: 3maxLength: 24 pattern: ^[a-zA-Z0-9]+$ |
Un nombre para la cuenta de lote que debe ser único dentro de la región. Los nombres de las cuentas de lote deben tener entre 3 y 24 caracteres de longitud y deben usar solo números y letras minúsculas. Este nombre se utiliza como parte del nombre DNS que se utiliza para acceder al servicio por lotes en la región donde se crea la cuenta. Por ejemplo: |
|
certificate
|
path | True |
string minLength: 5maxLength: 45 pattern: ^[\w]+-[\w]+$ |
Identificador del certificado. Esto debe estar formado por algoritmos y huellas digitales separados por un guión y debe coincidir con los datos del certificado en la solicitud. Por ejemplo, SHA1-a3d1c5. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas. |
|
subscription
|
path | True |
string (uuid) |
Identificador de la suscripción de destino. El valor debe ser un UUID. |
|
api-version
|
query | True |
string minLength: 1 |
Versión de API que se usará para la operación. |
Respuestas
| Nombre | Tipo | Description |
|---|---|---|
| 200 OK |
La solicitud se ha realizado correctamente. Encabezados ETag: string |
|
| Other Status Codes |
Una respuesta de error inesperada. |
Seguridad
azure_auth
Flujo de OAuth2 de Azure Active Directory.
Tipo:
oauth2
Flujo:
implicit
Dirección URL de autorización:
https://login.microsoftonline.com/common/oauth2/authorize
Ámbitos
| Nombre | Description |
|---|---|
| user_impersonation | suplantar la cuenta de usuario |
Ejemplos
| Get Certificate |
| Get Certificate with Deletion Error |
Get Certificate
Solicitud de ejemplo
Respuesta de muestra
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
Solicitud de ejemplo
Respuesta de muestra
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"
}
}
Definiciones
| Nombre | Description |
|---|---|
| Certificate |
Contiene información sobre un certificado. |
|
Certificate |
El formato del certificado: Pfx o Cer. Si se omite, el valor predeterminado es Pfx. |
|
Certificate |
|
|
Cloud |
Respuesta de error del servicio Batch. |
|
Cloud |
Respuesta de error del servicio Batch. |
|
created |
Tipo de identidad que creó el recurso. |
|
Delete |
Respuesta de error del servicio Batch. |
|
system |
Metadatos relativos a la creación y última modificación del recurso. |
Certificate
Contiene información sobre un certificado.
| Nombre | Tipo | Description |
|---|---|---|
| etag |
string |
ETag del recurso, que se usa para las instrucciones de simultaneidad. |
| id |
string (arm-id) |
Identificador de recurso completo para el recurso. Por ejemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
| name |
string |
Nombre del recurso |
| properties.deleteCertificateError |
Error que se produjo al eliminar el certificado. |
|
| properties.format |
El formato del certificado: Pfx o Cer. Si se omite, el valor predeterminado es Pfx. |
|
| properties.previousProvisioningState |
Estado aprovisionado anterior del recurso |
|
| properties.previousProvisioningStateTransitionTime |
string (date-time) |
Hora en la que el certificado entró en su estado anterior. |
| properties.provisioningState |
Estado aprovisionado del recurso |
|
| properties.provisioningStateTransitionTime |
string (date-time) |
Hora en la que el certificado entró en su estado actual. |
| properties.publicData |
string |
Clave pública del certificado. |
| properties.thumbprint |
string |
Huella digital del certificado. |
| properties.thumbprintAlgorithm |
string |
Algoritmo de la huella digital del certificado. |
| systemData |
Metadatos de Azure Resource Manager que contienen información createdBy y modifiedBy. |
|
| tags |
object |
Etiquetas del recurso. |
| type |
string |
Tipo del recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts" |
CertificateFormat
El formato del certificado: Pfx o Cer. Si se omite, el valor predeterminado es Pfx.
| Valor | Description |
|---|---|
| Pfx |
El certificado es un certificado con formato PFX (PKCS#12) o una cadena de certificados. |
| Cer |
El certificado es un certificado X.509 codificado en base64. |
CertificateProvisioningState
| Valor | Description |
|---|---|
| Succeeded |
El certificado está disponible para su uso en grupos. |
| Deleting |
El usuario ha solicitado que el certificado se elimine, pero la operación de eliminación aún no se ha completado. Es posible que no haga referencia al certificado al crear o actualizar grupos. |
| Failed |
El usuario solicitó que se elimine el certificado, pero hay grupos que todavía tienen referencias al certificado, o que todavía está instalado en uno o varios nodos de proceso. (Esto último puede ocurrir si el certificado se ha quitado del grupo, pero el nodo aún no se ha reiniciado. Los nodos solo actualizan sus certificados cuando se reinician). Puede usar la operación cancelar eliminación de certificados para cancelar la eliminación o la operación de eliminación del certificado para reintentar la eliminación. |
CloudError
Respuesta de error del servicio Batch.
| Nombre | Tipo | Description |
|---|---|---|
| error |
Cuerpo de la respuesta de error. |
CloudErrorBody
Respuesta de error del servicio Batch.
| Nombre | Tipo | Description |
|---|---|---|
| code |
string |
Identificador del error. Los códigos son invariables y están diseñados para consumirse mediante programación. |
| details |
Lista de detalles adicionales sobre el error. |
|
| message |
string |
Mensaje que describe el error, diseñado para ser adecuado para mostrarse en una interfaz de usuario. |
| target |
string |
Destino del error concreto. Por ejemplo, el nombre de la propiedad en error. |
createdByType
Tipo de identidad que creó el recurso.
| Valor | Description |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
DeleteCertificateError
Respuesta de error del servicio Batch.
| Nombre | Tipo | Description |
|---|---|---|
| code |
string |
Identificador del error. Los códigos son invariables y están diseñados para consumirse mediante programación. |
| details |
Lista de detalles adicionales sobre el error. |
|
| message |
string |
Mensaje que describe el error, diseñado para ser adecuado para mostrarse en una interfaz de usuario. |
| target |
string |
Destino del error concreto. Por ejemplo, el nombre de la propiedad en error. |
systemData
Metadatos relativos a la creación y última modificación del recurso.
| Nombre | Tipo | Description |
|---|---|---|
| createdAt |
string (date-time) |
Marca de tiempo de creación de recursos (UTC). |
| createdBy |
string |
Identidad que creó el recurso. |
| createdByType |
Tipo de identidad que creó el recurso. |
|
| lastModifiedAt |
string (date-time) |
Marca de tiempo de la última modificación del recurso (UTC) |
| lastModifiedBy |
string |
Identidad que modificó por última vez el recurso. |
| lastModifiedByType |
Tipo de identidad que modificó por última vez el recurso. |