Compartir a través de


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

string

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

certificateName
path True

string

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

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas.

subscriptionId
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

Certificate

La solicitud se ha realizado correctamente.

Encabezados

ETag: string

Other Status Codes

CloudError

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

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

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

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

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.

CertificateFormat

El formato del certificado: Pfx o Cer. Si se omite, el valor predeterminado es Pfx.

CertificateProvisioningState
CloudError

Respuesta de error del servicio Batch.

CloudErrorBody

Respuesta de error del servicio Batch.

createdByType

Tipo de identidad que creó el recurso.

DeleteCertificateError

Respuesta de error del servicio Batch.

systemData

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

DeleteCertificateError

Error que se produjo al eliminar el certificado.
Esto solo se devuelve cuando el valor de certificate provisioningState es "Failed".

properties.format

CertificateFormat

El formato del certificado: Pfx o Cer. Si se omite, el valor predeterminado es Pfx.

properties.previousProvisioningState

CertificateProvisioningState

Estado aprovisionado anterior del recurso

properties.previousProvisioningStateTransitionTime

string (date-time)

Hora en la que el certificado entró en su estado anterior.

properties.provisioningState

CertificateProvisioningState

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.
Debe coincidir con la huella digital del nombre.

properties.thumbprintAlgorithm

string

Algoritmo de la huella digital del certificado.
Debe coincidir con la primera parte del nombre del certificado. Actualmente debe ser "SHA1".

systemData

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

CloudErrorBody

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

CloudErrorBody[]

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

DeleteCertificateError[]

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

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

createdByType

Tipo de identidad que modificó por última vez el recurso.