Certificate - Get

Usługa:

Batch Service

Wersja interfejsu API:

2023-11-01.18.0

Pobiera informacje o określonym certyfikacie.
Ostrzeżenie: Ta operacja jest przestarzała i zostanie usunięta po lutym 2024 r. Zamiast tego użyj rozszerzenia Azure KeyVault .

GET {batchUrl}/certificates(thumbprintAlgorithm={thumbprintAlgorithm},thumbprint={thumbprint})?api-version=2023-11-01.18.0

Z parametrami opcjonalnymi:

GET {batchUrl}/certificates(thumbprintAlgorithm={thumbprintAlgorithm},thumbprint={thumbprint})?$select={$select}&timeout={timeout}&api-version=2023-11-01.18.0

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
batchUrl	path	True	string	Podstawowy adres URL dla wszystkich żądań obsługi Azure Batch.
thumbprint	path	True	string	Odcisk palca certyfikatu do pobrania.
thumbprintAlgorithm	path	True	string	Algorytm używany do wyprowadzenia parametru odcisku palca. Musi to być sha1.
api-version	query	True	string	Wersja interfejsu API klienta.
$select	query		string	Klauzula OData $select.
timeout	query		integer int32	Maksymalny czas przetwarzania żądania przez serwer w sekundach. Wartość domyślna to 30 sekund.

Nagłówek żądania

Media Types: "application/json; odata=minimalmetadata"

Nazwa	Wymagane	Typ	Opis
client-request-id		string uuid	Tożsamość żądania wygenerowanego przez obiekt wywołujący w postaci identyfikatora GUID bez dekoracji, takich jak nawiasy klamrowe, np. 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
return-client-request-id		boolean	Określa, czy serwer powinien zwrócić wartość client-request-id w odpowiedzi.
ocp-date		string date-time-rfc1123	Czas wystawienia żądania. Biblioteki klienckie zazwyczaj ustawiają tę wartość na bieżący czas zegara systemowego; ustaw go jawnie, jeśli bezpośrednio wywołujesz interfejs API REST.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	Certificate	Odpowiedź zawierająca certyfikat. Nagłówki client-request-id: string request-id: string ETag: string Last-Modified: string
Other Status Codes	BatchError	Błąd usługi Batch.

Zabezpieczenia

azure_auth

przepływ kodu uwierzytelniania OAuth 2.0 Microsoft Entra

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa	Opis
user_impersonation	Personifikuj konto użytkownika

Authorization

Typ: apiKey
W: header

Przykłady

Certificate get

Przykładowe żądanie

HTTP

GET account.region.batch.azure.com/certificates(thumbprintAlgorithm=sha1,thumbprint=0123456789abcdef0123456789abcdef01234567)?api-version=2023-11-01.18.0

Przykładowa odpowiedź

Kod stanu:

200

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

Definicje

Nazwa	Opis
BatchError	Odebrano odpowiedź o błędzie z usługi Azure Batch.
BatchErrorDetail	Element dodatkowych informacji zawartych w odpowiedzi na błąd Azure Batch.
Certificate	Certyfikat, który można zainstalować w węzłach obliczeniowych i może służyć do uwierzytelniania operacji na maszynie.
CertificateState	Stan certyfikatu.
DeleteCertificateError	Błąd napotkany przez usługę Batch podczas usuwania certyfikatu.
ErrorMessage	Komunikat o błędzie odebrany w odpowiedzi Azure Batch błędu.
NameValuePair	Reprezentuje parę nazwa-wartość.

BatchError

Odebrano odpowiedź o błędzie z usługi Azure Batch.

Nazwa	Typ	Opis
code	string	Identyfikator błędu. Kody są niezmienne i mają być używane programowo.
message	ErrorMessage	Komunikat opisujący błąd, który ma być odpowiedni do wyświetlania w interfejsie użytkownika.
values	BatchErrorDetail[]	Kolekcja par klucz-wartość zawierająca dodatkowe szczegóły dotyczące błędu.

BatchErrorDetail

Element dodatkowych informacji zawartych w odpowiedzi na błąd Azure Batch.

Nazwa	Typ	Opis
key	string	Identyfikator określający znaczenie właściwości Value.
value	string	Dodatkowe informacje zawarte w odpowiedzi na błąd.

Certificate

Certyfikat, który można zainstalować w węzłach obliczeniowych i może służyć do uwierzytelniania operacji na maszynie.

Nazwa	Typ	Opis
deleteCertificateError	DeleteCertificateError	Błąd, który wystąpił podczas ostatniej próby usunięcia tego certyfikatu. Ta właściwość jest ustawiana tylko wtedy, gdy właściwość Certificate jest w stanie DeleteFailed.
previousState	CertificateState	Poprzedni stan certyfikatu. Ta właściwość nie jest ustawiona, jeśli certyfikat jest w stanie początkowym aktywności.
previousStateTransitionTime	string	Czas, w którym certyfikat wprowadził poprzedni stan. Ta właściwość nie jest ustawiona, jeśli certyfikat jest w początkowym stanie Aktywny.
publicData	string	Publiczna część certyfikatu jako plik .cer zakodowany w formacie base-64.
state	CertificateState	Bieżący stan certyfikatu.
stateTransitionTime	string	Czas, w którym certyfikat wprowadził swój bieżący stan.
thumbprint	string	Odcisk palca X.509 certyfikatu. Jest to sekwencja maksymalnie 40 cyfr szesnastkowa.
thumbprintAlgorithm	string	Algorytm używany do uzyskiwania odcisku palca.
url	string	Adres URL certyfikatu.

CertificateState

Stan certyfikatu.

Nazwa	Typ	Opis
active	string	Certyfikat jest dostępny do użycia w pulach.
deletefailed	string	Użytkownik zażądał usunięcia certyfikatu, ale istnieją pule, które nadal mają odwołania do certyfikatu lub są nadal zainstalowane w co najmniej jednym węźle. (Ten ostatni może wystąpić, jeśli certyfikat został usunięty z puli, ale węzeł obliczeniowy nie został jeszcze uruchomiony ponownie. Węzły obliczeniowe odświeżają swoje certyfikaty tylko po ponownym uruchomieniu). Możesz użyć operacji anulowania usuwania certyfikatu, aby anulować usunięcie, lub operacji usuwania certyfikatu, aby ponowić próbę usunięcia.
deleting	string	Użytkownik zażądał usunięcia certyfikatu, ale operacja usuwania nie została jeszcze ukończona. Nie można odwołać się do certyfikatu podczas tworzenia lub aktualizowania pul.

DeleteCertificateError

Błąd napotkany przez usługę Batch podczas usuwania certyfikatu.

Nazwa	Typ	Opis
code	string	Identyfikator błędu usuwania certyfikatu. Kody są niezmienne i mają być używane programowo.
message	string	Komunikat opisujący błąd usuwania certyfikatu, który ma być odpowiedni do wyświetlania w interfejsie użytkownika.
values	NameValuePair[]	Lista dodatkowych szczegółów błędu związanych z błędem usuwania certyfikatu. Ta lista zawiera szczegółowe informacje, takie jak aktywne pule i węzły obliczeniowe odwołujące się do tego certyfikatu. Jeśli jednak duża liczba zasobów odwołuje się do certyfikatu, lista zawiera tylko około pierwszej setki.

ErrorMessage

Komunikat o błędzie odebrany w odpowiedzi Azure Batch błędu.

Nazwa	Typ	Opis
lang	string	Kod języka komunikatu o błędzie
value	string	Tekst wiadomości.

NameValuePair

Reprezentuje parę nazwa-wartość.

Nazwa	Typ	Opis
name	string	Nazwa w parze name-value.
value	string	Wartość w parze name-value.