Fleetspace - Create

Başvuru

Hizmet:: Cosmos DB Resource Provider

API Sürümü:: 2025-05-01-preview

Bir filonun altında bir Azure Cosmos DB filo alanı oluşturur.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/fleets/{fleetName}/fleetspaces/{fleetspaceName}?api-version=2025-05-01-preview

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
fleetName	path	True	string minLength: 3 maxLength: 50 pattern: ^[a-z0-9]+(-[a-z0-9]+)*	Cosmos DB filo adı. Bir abonelik altında benzersiz olması gerekir.
fleetspaceName	path	True	string minLength: 3 maxLength: 50 pattern: ^[a-z0-9]+(-[a-z0-9]+)*	Cosmos DB filo alanı adı. Bir filonun altında benzersiz olması gerekiyor.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Kaynak grubunun adı. Ad büyük/küçük harfe duyarsız.
subscriptionId	path	True	string (uuid)	Hedef aboneliğin kimliği. Değer bir UUID olmalıdır.
api-version	query	True	string minLength: 1	Bu işlem için kullanılacak API sürümü.

İstek Gövdesi

Name	Tür	Description
properties.fleetspaceApiKind	enum: NoSQL	Bu filo alanının ait olduğu API türü. Kabul edilebilir değerler: 'NoSQL'
properties.throughputPoolConfiguration	ThroughputPoolConfiguration	Filo alanında aktarım hızı havuzu için yapılandırma.

Yanıtlar

Name	Tür	Description
200 OK	FleetspaceResource	Zaman uyumlu olarak tamamlandı. Bu durum yalnızca düzeltme eki ile değiştirilen alanların gerçek filo alanında değişiklik gerektirmesi durumunda gerçekleşir.
201 Created	FleetspaceResource	Filo alanı zaman uyumsuz olarak oluşturuluyor veya güncelleştiriliyor.
Other Status Codes	ErrorResponse	İşlemin neden başarısız olduğunu açıklayan hata yanıtı.

Güvenlik

azure_auth

Azure Active Directory OAuth2 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ı taklit edin

Örnekler

CosmosDB Fleetspace Create

Örnek isteği

HTTP

PUT https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/rg1/providers/Microsoft.DocumentDB/fleets/fleet1/fleetspaces/fleetspace1?api-version=2025-05-01-preview

{
  "properties": {
    "fleetspaceApiKind": "NoSQL",
    "throughputPoolConfiguration": {
      "minThroughput": 100000,
      "maxThroughput": 500000,
      "serviceTier": "GeneralPurpose",
      "dataRegions": [
        "westus2"
      ]
    }
  }
}

Örnek yanıt

Durum kodu:: 200

{
  "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/rg1/providers/Microsoft.DocumentDB/fleets/fleet1/fleetspaces/fleetspace1",
  "name": "fleetspace1",
  "type": "Microsoft.DocumentDB/fleets/fleetspaces",
  "properties": {
    "provisioningState": "Succeeded",
    "fleetspaceApiKind": "NoSQL",
    "throughputPoolConfiguration": {
      "minThroughput": 100000,
      "maxThroughput": 500000,
      "serviceTier": "GeneralPurpose",
      "dataRegions": [
        "westus2"
      ]
    }
  }
}

Durum kodu:: 201

azure-AsyncOperation: https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/operationsStatus/{operationId}?api-version=2024-12-01-preview
location: https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/operationsStatus/{operationId}?api-version=2024-12-01-preview

{
  "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/rg1/providers/Microsoft.DocumentDB/fleets/fleet1/fleetspaces/fleetspace1",
  "name": "fleetspace1",
  "type": "Microsoft.DocumentDB/fleets/fleetspaces",
  "properties": {
    "provisioningState": "Succeeded",
    "fleetspaceApiKind": "NoSQL",
    "throughputPoolConfiguration": {
      "minThroughput": 100000,
      "maxThroughput": 500000,
      "serviceTier": "GeneralPurpose",
      "dataRegions": [
        "westus2"
      ]
    }
  }
}

Tanımlar

Name	Description
createdByType	Kaynağı oluşturan kimliğin türü.
ErrorAdditionalInfo	Kaynak yönetimi hatası ek bilgileri.
ErrorDetail	Hata ayrıntısı.
ErrorResponse	Hata yanıtı
FleetspaceResource	An Azure Cosmos DB Fleetspace.
status	Filonun sağlama durumu.
systemData	Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.
ThroughputPoolConfiguration	Filo alanında aktarım hızı havuzu için yapılandırma.

createdByType

Listeleme

Kaynağı oluşturan kimliğin türü.

Değer	Description
Application
Key
ManagedIdentity
User

ErrorAdditionalInfo

Object

Kaynak yönetimi hatası ek bilgileri.

Name	Tür	Description
info	object	Ek bilgiler.
type	string	Ek bilgi türü.

ErrorDetail

Object

Hata ayrıntısı.

Name	Tür	Description
additionalInfo	ErrorAdditionalInfo[]	Hata ek bilgileri.
code	string	Hata kodu.
details	ErrorDetail[]	Hata ayrıntıları.
message	string	Hata iletisi.
target	string	Hata hedefi.

ErrorResponse

Object

Hata yanıtı

Name	Tür	Description
error	ErrorDetail	Hata nesnesi.

FleetspaceResource

Object

An Azure Cosmos DB Fleetspace.

Name	Tür	Description
id	string (arm-id)	Kaynağın tam kaynak kimliği. Örneğin, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Kaynağın adı
properties.fleetspaceApiKind	enum: NoSQL	Bu filo alanının ait olduğu API türü. Kabul edilebilir değerler: 'NoSQL'
properties.provisioningState	status	Fleetspace'in sağlama durumu.
properties.throughputPoolConfiguration	ThroughputPoolConfiguration	Filo alanında aktarım hızı havuzu için yapılandırma.
systemData	systemData	createdBy ve modifiedBy bilgilerini içeren Azure Resource Manager meta verileri.
type	string	Kaynağın türü. Örneğin, "Microsoft.Compute/virtualMachines" veya "Microsoft.Storage/storageAccounts"

status

Listeleme

Filonun sağlama durumu.

Değer	Description
Canceled
Creating
Failed
Succeeded
Updating

systemData

Object

Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.

Name	Tür	Description
createdAt	string (date-time)	Kaynak oluşturma (UTC) zaman damgası.
createdBy	string	Kaynağı oluşturan kimlik.
createdByType	createdByType	Kaynağı oluşturan kimliğin türü.
lastModifiedAt	string (date-time)	Kaynağın son değişikliğinin zaman damgası (UTC)
lastModifiedBy	string	Kaynağı en son değiştiren kimlik.
lastModifiedByType	createdByType	Kaynağı en son değiştiren kimlik türü.

ThroughputPoolConfiguration

Object

Filo alanında aktarım hızı havuzu için yapılandırma.

Name	Tür	Description
dataRegions	string[]	Fleetspace'e atanan veri bölgelerinin listesi. Örneğin [westus2]
maxThroughput	integer (int32)	Havuz için en yüksek aktarım hızı.
minThroughput	integer (int32)	Havuz için en düşük aktarım hızı.
serviceTier	enum: BusinessCritical GeneralPurpose	Filo uzayı için Hizmet Katmanı. GeneralPurpose türleri bu filo uzaya eklenebilen tek yazma bölgesi hesaplarını ifade ederken, BusinessCritical birden çok yazma bölgesini ifade eder.

Aracılığıyla paylaş

Fleetspace - Create

URI Parametreleri

İstek Gövdesi

Yanıtlar

Güvenlik

azure_auth

Kapsamlar

Örnekler

CosmosDB Fleetspace Create

Örnek isteği

Örnek yanıt

Tanımlar

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

FleetspaceResource

status

systemData

ThroughputPoolConfiguration