Aracılığıyla paylaş


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
batchUrl
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

CertificateListResult

Sertifikalar listesini içeren bir yanıt.

Üst Bilgiler

  • client-request-id: string
  • request-id: string
  • ETag: string
  • Last-Modified: string
Other Status Codes

BatchError

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
BatchError

Azure Batch hizmetinden alınan bir hata yanıtı.

BatchErrorDetail

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.

CertificateListResult

Hesaptaki Sertifikaları listelemenin sonucu.

CertificateState

Sertifikanın durumu.

DeleteCertificateError

Sertifika silinirken Batch hizmeti tarafından karşılaşılan bir hata.

ErrorMessage

Azure Batch hata yanıtında bir hata iletisi alındı.

NameValuePair

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

ErrorMessage

Hatayı açıklayan ve kullanıcı arabiriminde görüntülenmeye uygun olması amaçlanan bir ileti.

values

BatchErrorDetail[]

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

DeleteCertificateError

Bu Sertifikayı silmeye son denemede oluşan hata.
Bu özellik yalnızca Sertifika DeleteFailed durumundaysa ayarlanır.

previousState

CertificateState

Sertifikanın önceki durumu.
Sertifika ilk etkin durumundaysa bu özellik ayarlanmaz.

previousStateTransitionTime

string

Sertifikanın önceki durumuna girdiği saat.
Sertifika ilk Etkin durumundaysa bu özellik ayarlanmaz.

publicData

string

Sertifikanın base-64 kodlanmış .cer dosyası olarak ortak bölümü.

state

CertificateState

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

Certificate[]

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

NameValuePair[]

Sertifika silme hatasıyla ilgili ek hata ayrıntılarının listesi.
Bu liste, bu Sertifikaya başvuran etkin Havuzlar ve İşlem Düğümleri gibi ayrıntıları içerir. Ancak, sertifikaya çok sayıda kaynak başvuruda bulunursa, listede yalnızca ilk yüz kaynak bulunur.

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.