Compartir a través de


Certificate - List By Batch Account

Enumera todos los certificados de la cuenta especificada.
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?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}

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

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.

$filter
query

string

Expresión de filtro de OData. Las propiedades válidas para el filtrado son "properties/provisioningState", "properties/provisioningStateTransitionTime", "name".

$select
query

string

Lista separada por comas de propiedades que se deben devolver. Por ejemplo, "properties/provisioningState". Solo las propiedades de nivel superior en propiedades/ son válidas para la selección.

maxresults
query

integer (int32)

Número máximo de elementos que se van a devolver en la respuesta.

Respuestas

Nombre Tipo Description
200 OK

ListCertificatesResult

La operación de Azure se completó correctamente.

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

ListCertificates
ListCertificates - Filter and Select

ListCertificates

Solicitud de ejemplo

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

Respuesta de muestra

{
  "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

Solicitud de ejemplo

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'

Respuesta de muestra

{
  "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"
      }
    }
  ]
}

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.

ListCertificatesResult

Valores devueltos por la operación List.

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.

ListCertificatesResult

Valores devueltos por la operación List.

Nombre Tipo Description
nextLink

string (uri)

El enlace a la siguiente página de artículos

value

Certificate[]

Los elementos del Certificado en esta página

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.