Certificate - Get
Ottiene informazioni sul certificato specificato.
Avviso: questa operazione è deprecata e verrà rimossa dopo febbraio 2024. Usare invece l'estensione Azure KeyVault .
GET {batchUrl}/certificates(thumbprintAlgorithm={thumbprintAlgorithm},thumbprint={thumbprint})?api-version=2023-11-01.18.0
GET {batchUrl}/certificates(thumbprintAlgorithm={thumbprintAlgorithm},thumbprint={thumbprint})?$select={$select}&timeout={timeout}&api-version=2023-11-01.18.0
Parametri dell'URI
Nome | In | Necessario | Tipo | Descrizione |
---|---|---|---|---|
batch
|
path | True |
string |
URL di base per tutte le richieste di servizio Azure Batch. |
thumbprint
|
path | True |
string |
Identificazione personale del certificato da ottenere. |
thumbprint
|
path | True |
string |
Algoritmo usato per derivare il parametro identificazione personale. Questo deve essere sha1. |
api-version
|
query | True |
string |
Versione dell'API client. |
$select
|
query |
string |
Clausola di $select OData. |
|
timeout
|
query |
integer int32 |
Tempo massimo per cui il server può trascorrere l'elaborazione della richiesta, in secondi. Il valore predefinito è 30 secondi. |
Intestazione della richiesta
Media Types: "application/json; odata=minimalmetadata"
Nome | Necessario | Tipo | Descrizione |
---|---|---|---|
client-request-id |
string uuid |
Identità richiesta generata dal chiamante, sotto forma di GUID senza decorazioni come parentesi graffe, ad esempio 9C4D50E-2D56-4CD3-8152-34347DC9F2B0. |
|
return-client-request-id |
boolean |
Se il server deve restituire l'ID richiesta client nella risposta. |
|
ocp-date |
string date-time-rfc1123 |
Ora in cui è stata eseguita la richiesta. Le librerie client in genere impostano l'ora dell'orologio del sistema corrente; impostarla in modo esplicito se si chiama direttamente l'API REST. |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
200 OK |
Risposta contenente il certificato. Intestazioni
|
|
Other Status Codes |
Errore dal servizio Batch. |
Sicurezza
azure_auth
Microsoft Entra flusso di codice di autenticazione OAuth 2.0
Tipo:
oauth2
Flow:
implicit
URL di autorizzazione:
https://login.microsoftonline.com/common/oauth2/authorize
Ambiti
Nome | Descrizione |
---|---|
user_impersonation | Rappresentare l'account utente |
Authorization
Tipo:
apiKey
In:
header
Esempio
Certificate get
Esempio di richiesta
GET account.region.batch.azure.com/certificates(thumbprintAlgorithm=sha1,thumbprint=0123456789abcdef0123456789abcdef01234567)?api-version=2023-11-01.18.0
Risposta di esempio
{
"thumbprint": "0123456789abcdef0123456789abcdef01234567",
"thumbprintAlgorithm": "sha1",
"url": "https://account.region.batch.azure.com/certificates(thumbprintAlgorithm=sha1,thumbprint=0123456789abcdef0123456789abcdef01234567)",
"state": "deletefailed",
"stateTransitionTime": "2014-07-31T21:12:58.236Z",
"previousState": "deleting",
"previousStateTransitionTime": "2014-07-31T21:11:58.236Z",
"publicData": "#####...",
"deleteCertificateError": {
"code": "PoolsReferencingCertificate",
"message": "The specified certificate is being used by the below mentioned pool(s)",
"values": [
{
"name": "Pools",
"value": "mypool1"
}
]
}
}
Definizioni
Nome | Descrizione |
---|---|
Batch |
Risposta di errore ricevuta dal servizio Azure Batch. |
Batch |
Elemento di informazioni aggiuntive incluse in una risposta di errore Azure Batch. |
Certificate |
Un certificato che può essere installato nei nodi di calcolo e può essere usato per autenticare le operazioni nel computer. |
Certificate |
Stato del certificato. |
Delete |
Errore rilevato dal servizio Batch durante l'eliminazione di un certificato. |
Error |
Messaggio di errore ricevuto in una risposta di errore Azure Batch. |
Name |
Rappresenta una coppia nome/valore. |
BatchError
Risposta di errore ricevuta dal servizio Azure Batch.
Nome | Tipo | Descrizione |
---|---|---|
code |
string |
Identificatore dell'errore. I codici sono invarianti e devono essere usati a livello di codice. |
message |
Messaggio che descrive l'errore, destinato a essere adatto per la visualizzazione in un'interfaccia utente. |
|
values |
Raccolta di coppie chiave-valore contenenti dettagli aggiuntivi sull'errore. |
BatchErrorDetail
Elemento di informazioni aggiuntive incluse in una risposta di errore Azure Batch.
Nome | Tipo | Descrizione |
---|---|---|
key |
string |
Identificatore che specifica il significato della proprietà Value. |
value |
string |
Informazioni aggiuntive incluse nella risposta all'errore. |
Certificate
Un certificato che può essere installato nei nodi di calcolo e può essere usato per autenticare le operazioni nel computer.
Nome | Tipo | Descrizione |
---|---|---|
deleteCertificateError |
Errore che si è verificato nell'ultimo tentativo di eliminare questo certificato. |
|
previousState |
Stato precedente del certificato. |
|
previousStateTransitionTime |
string |
Ora in cui il certificato ha immesso lo stato precedente. |
publicData |
string |
Parte pubblica del certificato come file di .cer codificato in base 64. |
state |
Stato corrente del certificato. |
|
stateTransitionTime |
string |
Ora in cui il certificato ha immesso lo stato corrente. |
thumbprint |
string |
Identificazione personale X.509 del certificato. Si tratta di una sequenza di fino a 40 cifre esadecimale. |
thumbprintAlgorithm |
string |
Algoritmo usato per derivare l'identificazione personale. |
url |
string |
URL del certificato. |
CertificateState
Stato del certificato.
Nome | Tipo | Descrizione |
---|---|---|
active |
string |
Il certificato è disponibile per l'uso nei pool. |
deletefailed |
string |
L'utente ha richiesto l'eliminazione del certificato, ma sono presenti pool che hanno ancora riferimenti al certificato oppure è ancora installato in uno o più nodi. Quest'ultimo può verificarsi se il certificato è stato rimosso dal pool, ma il nodo di calcolo non è ancora stato riavviato. I nodi di calcolo aggiornano i certificati solo quando vengono riavviati. È possibile usare l'operazione di eliminazione del certificato annulla per annullare l'eliminazione o l'operazione elimina certificato per riprovare l'eliminazione. |
deleting |
string |
L'utente ha richiesto l'eliminazione del certificato, ma l'operazione di eliminazione non è ancora stata completata. Non è possibile fare riferimento al certificato durante la creazione o l'aggiornamento dei pool. |
DeleteCertificateError
Errore rilevato dal servizio Batch durante l'eliminazione di un certificato.
Nome | Tipo | Descrizione |
---|---|---|
code |
string |
Identificatore per l'errore di eliminazione del certificato. I codici sono invarianti e devono essere usati a livello di codice. |
message |
string |
Messaggio che descrive l'errore di eliminazione del certificato, destinato a essere adatto per la visualizzazione in un'interfaccia utente. |
values |
Elenco di dettagli di errore aggiuntivi correlati all'errore di eliminazione del certificato. |
ErrorMessage
Messaggio di errore ricevuto in una risposta di errore Azure Batch.
Nome | Tipo | Descrizione |
---|---|---|
lang |
string |
Codice del linguaggio del messaggio di errore |
value |
string |
Testo del messaggio. |
NameValuePair
Rappresenta una coppia nome/valore.
Nome | Tipo | Descrizione |
---|---|---|
name |
string |
Nome nella coppia nome-valore. |
value |
string |
Valore nella coppia nome-valore. |