Certificate - List

Odwołanie

Usługa:: Batch Service

Wersja interfejsu API:: 2024-07-01.20.0

Wyświetla listę wszystkich certyfikatów, które zostały dodane do określonego konta.
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?api-version=2024-07-01.20.0

Z parametrami opcjonalnymi:

GET {batchUrl}/certificates?$filter={$filter}&$select={$select}&maxresults={maxresults}&timeout={timeout}&api-version=2024-07-01.20.0

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
batchUrl	path	True	string	Podstawowy adres URL dla wszystkich żądań usługi Azure Batch.
api-version	query	True	string	Wersja interfejsu API klienta.
$filter	query		string	Klauzula OData $filter. Aby uzyskać więcej informacji na temat konstruowania tego filtru, zobacz https://docs.microsoft.com/rest/api/batchservice/odata-filters-in-batch#list-certificates.
$select	query		string	Klauzula OData $select.
maxresults	query		integer int32	Maksymalna liczba elementów do zwrócenia w odpowiedzi. Można zwrócić maksymalnie 1000 certyfikatów.
timeout	query		integer int32	Maksymalny czas przetwarzania żądania przez serwer w sekundach. Wartość domyślna to 30 sekund. Jeśli wartość jest większa niż 30, zostanie użyta wartość domyślna.

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, takiej jak nawiasy klamrowe, np. 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
return-client-request-id		boolean	Czy serwer powinien zwrócić identyfikator żądania klienta 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

CertificateListResult

Odpowiedź zawierająca listę certyfikatów.

Nagłówki

client-request-id: string
request-id: string
ETag: string
Last-Modified: string

Other Status Codes

Błąd usługi Batch.

Zabezpieczenia

azure_auth

Microsoft Entra OAuth 2.0 — przepływ kodu uwierzytelniania

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 list

Przykładowe żądanie

HTTP

GET account.region.batch.azure.com/certificates?api-version=2024-07-01.20.0

Przykładowa odpowiedź

Kod stanu:: 200

{
  "value": [
    {
      "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 usługi 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.
CertificateListResult	Wynik wyświetlania listy certyfikatów na koncie.
CertificateState	Stan certyfikatu.
DeleteCertificateError	Błąd napotkany przez usługę Batch podczas usuwania certyfikatu.
ErrorMessage	Komunikat o błędzie odebrany w odpowiedzi na błąd usługi Azure Batch.
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 usługi 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 certyfikat 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ł bieżący stan.
thumbprint	string	Odcisk palca X.509 certyfikatu. Jest to sekwencja z maksymalnie 40 cyframi szesnastkowymi.
thumbprintAlgorithm	string	Algorytm używany do uzyskiwania odcisku palca.
url	string	Adres URL certyfikatu.

CertificateListResult

Wynik wyświetlania listy certyfikatów na koncie.

Nazwa	Typ	Opis
odata.nextLink	string	Adres URL umożliwiający uzyskanie następnego zestawu wyników.
value	Certificate[]	Lista certyfikatów.

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 jest on nadal zainstalowany 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 wiele zasobów odwołuje się do certyfikatu, lista zawiera tylko około pierwszej setki.

ErrorMessage

Komunikat o błędzie odebrany w odpowiedzi na błąd usługi Azure Batch.

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.