Certificate - Get

Referensi

Service:: Batch Service

API Version:: 2023-11-01.18.0

Mendapatkan informasi tentang Sertifikat yang ditentukan.
Peringatan: Operasi ini tidak digunakan lagi dan akan dihapus setelah Februari 2024. Silakan gunakan Ekstensi Azure KeyVault sebagai gantinya.

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

With optional parameters:

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
batchUrl	path	True	string	URL dasar untuk semua permintaan layanan Azure Batch.
thumbprint	path	True	string	Thumbprint Sertifikat yang akan didapatkan.
thumbprintAlgorithm	path	True	string	Algoritma yang digunakan untuk memperoleh parameter thumbprint. Ini harus sha1.
api-version	query	True	string	Versi API Klien.
$select	query		string	Klausa $select OData.
timeout	query		integer int32	Waktu maksimum yang dapat dihabiskan server untuk memproses permintaan, dalam hitung detik. Defaultnya adalah 30 detik.

Header Permintaan

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

Nama	Jenis	Deskripsi
client-request-id	string uuid	Identitas permintaan yang dihasilkan pemanggil, dalam bentuk GUID tanpa dekorasi seperti kurung kurawal, misalnya 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
return-client-request-id	boolean	Apakah server harus mengembalikan client-request-id dalam respons.
ocp-date	string date-time-rfc1123	Waktu permintaan dikeluarkan. Pustaka klien biasanya mengatur ini ke waktu jam sistem saat ini; atur secara eksplisit jika Anda memanggil REST API secara langsung.

Respons

Nama	Jenis	Deskripsi
200 OK	Certificate	Respons yang berisi Sertifikat. Headers client-request-id: string request-id: string ETag: string Last-Modified: string
Other Status Codes	BatchError	Kesalahan dari layanan Batch.

Nama

Jenis

Deskripsi

200 OK

Certificate

Respons yang berisi Sertifikat.

Headers

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

Other Status Codes

BatchError

Kesalahan dari layanan Batch.

Keamanan

azure_auth

Microsoft Entra alur kode autentikasi OAuth 2.0

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nama	Deskripsi
user_impersonation	Meniru akun pengguna Anda

Authorization

Type: apiKey
In: header

Contoh

Certificate get

Sample Request

HTTP

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

Sample Response

Status code:: 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"
      }
    ]
  }
}

Definisi

Nama	Deskripsi
BatchError	Respons kesalahan yang diterima dari layanan Azure Batch.
BatchErrorDetail	Item informasi tambahan yang disertakan dalam respons kesalahan Azure Batch.
Certificate	Sertifikat yang dapat diinstal pada Simpul Komputasi dan dapat digunakan untuk mengautentikasi operasi pada komputer.
CertificateState	Status Sertifikat.
DeleteCertificateError	Kesalahan yang ditemui oleh layanan Batch saat menghapus Sertifikat.
ErrorMessage	Pesan kesalahan yang diterima dalam respons kesalahan Azure Batch.
NameValuePair	Mewakili pasangan nama-nilai.

BatchError

Respons kesalahan yang diterima dari layanan Azure Batch.

Nama	Jenis	Deskripsi
code	string	Pengidentifikasi untuk kesalahan. Kode tidak berubah dan dimaksudkan untuk dikonsumsi secara terprogram.
message	ErrorMessage	Pesan yang menjelaskan kesalahan, dimaksudkan agar cocok untuk ditampilkan di antarmuka pengguna.
values	BatchErrorDetail[]	Kumpulan pasangan kunci-nilai yang berisi detail tambahan tentang kesalahan.

BatchErrorDetail

Item informasi tambahan yang disertakan dalam respons kesalahan Azure Batch.

Nama	Jenis	Deskripsi
key	string	Pengidentifikasi yang menentukan arti properti Nilai.
value	string	Informasi tambahan disertakan dengan respons kesalahan.

Certificate

Sertifikat yang dapat diinstal pada Simpul Komputasi dan dapat digunakan untuk mengautentikasi operasi pada komputer.

Nama	Jenis	Deskripsi
deleteCertificateError	DeleteCertificateError	Kesalahan yang terjadi pada upaya terakhir untuk menghapus Sertifikat ini. Properti ini diatur hanya jika Sertifikat berada dalam status DeleteFailed.
previousState	CertificateState	Status Sertifikat sebelumnya. Properti ini tidak diatur jika Sertifikat dalam status aktif awal.
previousStateTransitionTime	string	Waktu saat Sertifikat memasuki status sebelumnya. Properti ini tidak diatur jika Sertifikat dalam status Aktif awal.
publicData	string	Bagian publik dari Sertifikat sebagai file .cer yang dikodekan base-64.
state	CertificateState	Status Sertifikat saat ini.
stateTransitionTime	string	Waktu saat Sertifikat memasuki statusnya saat ini.
thumbprint	string	Thumbprint X.509 sertifikat. Ini adalah urutan hingga 40 digit hex.
thumbprintAlgorithm	string	Algoritma yang digunakan untuk memperoleh thumbprint.
url	string	URL Sertifikat.

CertificateState

Status Sertifikat.

Nama	Jenis	Deskripsi
active	string	Sertifikat tersedia untuk digunakan di Kumpulan.
deletefailed	string	Pengguna meminta agar Sertifikat dihapus, tetapi ada Kumpulan yang masih memiliki referensi ke Sertifikat, atau masih diinstal pada satu atau beberapa Simpul. (Yang terakhir dapat terjadi jika Sertifikat telah dihapus dari Kumpulan, tetapi Simpul Komputasi belum dimulai ulang. Simpul Komputasi merefresh Sertifikat mereka hanya saat dimulai ulang.) Anda dapat menggunakan operasi batalkan Penghapusan sertifikat untuk membatalkan penghapusan, atau operasi hapus Sertifikat untuk mencoba kembali penghapusan.
deleting	string	Pengguna telah meminta agar Sertifikat dihapus, tetapi operasi penghapusan belum selesai. Anda mungkin tidak mereferensikan Sertifikat saat membuat atau memperbarui Kumpulan.

DeleteCertificateError

Kesalahan yang ditemui oleh layanan Batch saat menghapus Sertifikat.

Nama	Jenis	Deskripsi
code	string	Pengidentifikasi untuk kesalahan penghapusan Sertifikat. Kode tidak berubah dan dimaksudkan untuk dikonsumsi secara terprogram.
message	string	Pesan yang menjelaskan kesalahan penghapusan Sertifikat, dimaksudkan agar cocok untuk ditampilkan di antarmuka pengguna.
values	NameValuePair[]	Daftar detail kesalahan tambahan yang terkait dengan kesalahan penghapusan Sertifikat. Daftar ini mencakup detail seperti Kumpulan aktif dan Simpul Komputasi yang merujuk Sertifikat ini. Namun, jika sejumlah besar sumber daya mereferensikan Sertifikat, daftar hanya berisi sekitar seratus pertama.

ErrorMessage

Pesan kesalahan yang diterima dalam respons kesalahan Azure Batch.

Nama	Jenis	Deskripsi
lang	string	Kode bahasa pesan kesalahan
value	string	Teks pesan.

NameValuePair

Mewakili pasangan nama-nilai.

Nama	Jenis	Deskripsi
name	string	Nama dalam pasangan nama-nilai.
value	string	Nilai dalam pasangan nama-nilai.

Certificate - Get

Parameter URI

Header Permintaan

Respons

Keamanan

azure_auth

Scopes

Authorization

Contoh

Certificate get

Sample Request

Sample Response

Definisi

BatchError

BatchErrorDetail

Certificate

CertificateState

DeleteCertificateError

ErrorMessage

NameValuePair

Sumber Daya Tambahan: