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 |
|---|---|---|---|---|
|
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: |
|
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. |
|
$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 |
La operación de Azure se completó correctamente. |
|
| 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
|
List |
|
List |
ListCertificates
Solicitud de ejemplo
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. |
|
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. |
|
List |
Valores devueltos por la operación List. |
|
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. |
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 |
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 |
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. |