Certificate - List
Belirtilen Hesaba eklenmiş olan tüm Sertifikaları listeler.
Uyarı: Bu işlem kullanım dışı bırakıldı ve Şubat 2024'den sonra kaldırılacak. Bunun yerine Azure KeyVault Uzantısı kullanın.
GET {batchUrl}/certificates?api-version=2024-07-01.20.0
GET {batchUrl}/certificates?$filter={$filter}&$select={$select}&maxresults={maxresults}&timeout={timeout}&api-version=2024-07-01.20.0
URI Parametreleri
Name | İçinde | Gerekli | Tür | Description |
---|---|---|---|---|
batch
|
path | True |
string |
Tüm Azure Batch hizmet isteklerinin temel URL'si. |
api-version
|
query | True |
string |
İstemci API Sürümü. |
$filter
|
query |
string |
OData $filter yan tümcesi. Bu filtreyi oluşturma hakkında daha fazla bilgi için bkz. https://learn.microsoft.com/rest/api/batchservice/odata-filters-in-batch#list-certificates. |
|
$select
|
query |
string |
OData $select yan tümcesi. |
|
maxresults
|
query |
integer int32 |
Yanıtta döndürülecek en fazla öğe sayısı. En fazla 1000 Sertifika döndürülebilir. |
|
timeout
|
query |
integer int32 |
Sunucunun isteği işlemek için harcayabileceği en uzun süre (saniye cinsinden). Varsayılan değer 30 saniyedir. Değer 30'dan büyükse, bunun yerine varsayılan değer kullanılır. |
İstek Başlığı
Media Types: "application/json; odata=minimalmetadata"
Name | Gerekli | Tür | Description |
---|---|---|---|
client-request-id |
string uuid |
Arayan tarafından oluşturulan istek kimliği, küme ayraçları gibi süslemesi olmayan bir GUID biçiminde, örneğin 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0. |
|
return-client-request-id |
boolean |
Sunucunun yanıtta client-request-id döndürip döndürmeyeceği. |
|
ocp-date |
string date-time-rfc1123 |
İsteğin verildiği saat. İstemci kitaplıkları bunu genellikle geçerli sistem saat saatine ayarlar; REST API'yi doğrudan çağırıyorsanız açıkça ayarlayın. |
Yanıtlar
Name | Tür | Description |
---|---|---|
200 OK |
Sertifikalar listesini içeren bir yanıt. Üst Bilgiler
|
|
Other Status Codes |
Batch hizmetinden gelen hata. |
Güvenlik
azure_auth
Microsoft Entra OAuth 2.0 kimlik doğrulama kodu akışı
Tür:
oauth2
Akış:
implicit
Yetkilendirme URL’si:
https://login.microsoftonline.com/common/oauth2/authorize
Kapsamlar
Name | Description |
---|---|
user_impersonation | Kullanıcı hesabınızın kimliğine bürünme |
Authorization
Tür:
apiKey
İçinde:
header
Örnekler
Certificate list
Örnek isteği
GET account.region.batch.azure.com/certificates?api-version=2024-07-01.20.0
Örnek yanıt
{
"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"
}
]
}
}
]
}
Tanımlar
Name | Description |
---|---|
Batch |
Azure Batch hizmetinden alınan bir hata yanıtı. |
Batch |
Azure Batch hata yanıtına dahil edilen ek bilgilerden oluşan bir öğe. |
Certificate |
İşlem Düğümlerine yüklenebilen ve makinedeki işlemlerin kimliğini doğrulamak için kullanılabilen bir Sertifika. |
Certificate |
Hesaptaki Sertifikaları listelemenin sonucu. |
Certificate |
Sertifikanın durumu. |
Delete |
Sertifika silinirken Batch hizmeti tarafından karşılaşılan bir hata. |
Error |
Azure Batch hata yanıtında bir hata iletisi alındı. |
Name |
Ad-değer çiftini temsil eder. |
BatchError
Azure Batch hizmetinden alınan bir hata yanıtı.
Name | Tür | Description |
---|---|---|
code |
string |
Hatanın tanımlayıcısı. Kodlar sabittir ve program aracılığıyla kullanılması amaçlanmıştır. |
message |
Hatayı açıklayan ve kullanıcı arabiriminde görüntülenmeye uygun olması amaçlanan bir ileti. |
|
values |
Hata hakkında ek ayrıntılar içeren anahtar-değer çiftleri koleksiyonu. |
BatchErrorDetail
Azure Batch hata yanıtına dahil edilen ek bilgilerden oluşan bir öğe.
Name | Tür | Description |
---|---|---|
key |
string |
Value özelliğinin anlamını belirten tanımlayıcı. |
value |
string |
Hata yanıtına eklenen ek bilgiler. |
Certificate
İşlem Düğümlerine yüklenebilen ve makinedeki işlemlerin kimliğini doğrulamak için kullanılabilen bir Sertifika.
Name | Tür | Description |
---|---|---|
deleteCertificateError |
Bu Sertifikayı silmeye son denemede oluşan hata. |
|
previousState |
Sertifikanın önceki durumu. |
|
previousStateTransitionTime |
string |
Sertifikanın önceki durumuna girdiği saat. |
publicData |
string |
Sertifikanın base-64 kodlanmış .cer dosyası olarak ortak bölümü. |
state |
Sertifikanın geçerli durumu. |
|
stateTransitionTime |
string |
Sertifikanın geçerli durumuna girdiği saat. |
thumbprint |
string |
Sertifikanın X.509 parmak izi. Bu, en fazla 40 onaltılık basamak dizisidir. |
thumbprintAlgorithm |
string |
Parmak izini türetmek için kullanılan algoritma. |
url |
string |
Sertifikanın URL'si. |
CertificateListResult
Hesaptaki Sertifikaları listelemenin sonucu.
Name | Tür | Description |
---|---|---|
odata.nextLink |
string |
Sonraki sonuç kümesini almak için URL. |
value |
Sertifikalar listesi. |
CertificateState
Sertifikanın durumu.
Name | Tür | Description |
---|---|---|
active |
string |
Sertifika Havuzlar'da kullanılabilir. |
deletefailed |
string |
Kullanıcı Sertifikanın silinmesini istedi, ancak Sertifikaya hala başvuruda bulunan havuzlar var veya bir veya daha fazla Düğümde yüklü. (Sertifika Havuzdan kaldırıldıysa ancak İşlem Düğümü henüz yeniden başlatılmadıysa, ikincisi oluşabilir. İşlem Düğümleri sertifikalarını yalnızca yeniden başlatıldığında yeniler.) Silme işlemini iptal etmek için Sertifika silme işlemini veya silmeyi yeniden denemek için Sertifika silme işlemini kullanabilirsiniz. |
deleting |
string |
Kullanıcı Sertifikanın silinmesini istedi, ancak silme işlemi henüz tamamlanmadı. Havuzları oluştururken veya güncelleştirirken Sertifikaya başvuramayasınız. |
DeleteCertificateError
Sertifika silinirken Batch hizmeti tarafından karşılaşılan bir hata.
Name | Tür | Description |
---|---|---|
code |
string |
Sertifika silme hatasının tanımlayıcısı. Kodlar sabittir ve program aracılığıyla kullanılması amaçlanmıştır. |
message |
string |
Kullanıcı arabiriminde görüntülenmeye uygun olması amaçlanan Sertifika silme hatasını açıklayan bir ileti. |
values |
Sertifika silme hatasıyla ilgili ek hata ayrıntılarının listesi. |
ErrorMessage
Azure Batch hata yanıtında bir hata iletisi alındı.
Name | Tür | Description |
---|---|---|
lang |
string |
Hata iletisinin dil kodu |
value |
string |
İletinin metni. |
NameValuePair
Ad-değer çiftini temsil eder.
Name | Tür | Description |
---|---|---|
name |
string |
Ad-değer çiftindeki ad. |
value |
string |
Ad-değer çiftindeki değer. |