Cassandra Resources - Update Cassandra Keyspace Throughput

Aktualizowanie jednostek RU na sekundę w usłudze Azure Cosmos DB Cassandra Keyspace

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/cassandraKeyspaces/{keyspaceName}/throughputSettings/default?api-version=2021-07-01-preview

Parametry identyfikatora URI

Name In Required Type Description
accountName
path True
  • string

Nazwa konta bazy danych usługi Cosmos DB.

Regex pattern: ^[a-z0-9]+(-[a-z0-9]+)*

keyspaceName
path True
  • string

Nazwa przestrzeni kluczy usługi Cosmos DB.

resourceGroupName
path True
  • string

Nazwa grupy zasobów. W nazwie jest uwzględniana wielkość liter.

subscriptionId
path True
  • string

Identyfikator subskrypcji docelowej.

api-version
query True
  • string

Wersja interfejsu API do użycia na potrzeby tej operacji.

Treść żądania

Name Required Type Description
properties.resource True

Standardowy format JSON przepływności zasobów

identity

Tożsamość zasobu.

location
  • string

Lokalizacja grupy zasobów, do której należy zasób.

tags
  • object

Tagi to lista par klucz-wartość, które opisują zasób. Te tagi mogą służyć do wyświetlania i grupowania tego zasobu (między grupami zasobów). Dla zasobu można podać maksymalnie 15 tagów. Każdy tag musi mieć klucz nie większy niż 128 znaków i wartość nie większą niż 256 znaków. Na przykład domyślne środowisko dla typu szablonu jest ustawiane z wartością "defaultExperience": "Cassandra". Bieżące wartości "defaultExperience" obejmują również wartości "Table", "Graph", "DocumentDB" i "MongoDB".

Odpowiedzi

Name Type Description
200 OK

Liczba jednostek RU na sekundę operacji aktualizacji usługi Cassandra Keyspace została ukończona pomyślnie.

202 Accepted

Jednostki RU na sekundę operacji aktualizacji usługi Cassandra Keyspace zostaną ukończone asynchronicznie.

Zabezpieczenia

azure_auth

Przepływ OAuth2 usługi Azure Active Directory

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

Scopes

Name Description
user_impersonation Personifikuj konto użytkownika

Przykłady

CosmosDBCassandraKeyspaceThroughputUpdate

Sample Request

PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1/cassandraKeyspaces/keyspaceName/throughputSettings/default?api-version=2021-07-01-preview

{
  "location": "West US",
  "tags": {},
  "properties": {
    "resource": {
      "throughput": 400
    }
  }
}

Sample Response

{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1/cassandraKeyspaces/keyspaceName/throughputSettings/default",
  "name": "default",
  "type": "Microsoft.DocumentDB/databaseAccounts/cassandraKeyspaces/throughputSettings",
  "location": "West US",
  "tags": {},
  "properties": {
    "resource": {
      "throughput": 400,
      "minimumThroughput": "400",
      "offerReplacePending": "true",
      "_rid": "PD5DALigDgw=",
      "_ts": 1459200611,
      "_etag": "\"00005900-0000-0000-0000-56f9a2630000\""
    }
  }
}

Definicje

AutoscaleSettingsResource

Obiekt ustawień aprowizowanej przepływności usługi Cosmos DB

AutoUpgradePolicyResource

Zasady automatycznego uaktualniania zasobów usługi Cosmos DB

ManagedServiceIdentity

Tożsamość zasobu.

Resource
ResourceIdentityType

Typ tożsamości używanej dla zasobu. Typ "SystemAssigned,UserAssigned" zawiera zarówno niejawnie utworzoną tożsamość, jak i zestaw tożsamości przypisanych przez użytkownika. Typ "Brak" spowoduje usunięcie wszystkich tożsamości z usługi.

ThroughputPolicyResource

Zasady przepływności zasobów usługi Cosmos DB

ThroughputSettingsGetResults

Przepływność zasobów usługi Azure Cosmos DB.

ThroughputSettingsResource

Obiekt przepływności zasobów usługi Cosmos DB. Wymagana jest przepływność lub autoskalowanieUstawienia jest wymagane, ale nie oba.

ThroughputSettingsUpdateParameters

Parametry do aktualizowania przepływności zasobów usługi Cosmos DB.

UserAssignedIdentities

Lista tożsamości użytkowników skojarzonych z zasobem. Odwołania do klucza słownika tożsamości użytkownika będą identyfikatorami zasobów usługi ARM w postaci: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}".

AutoscaleSettingsResource

Obiekt ustawień aprowizowanej przepływności usługi Cosmos DB

Name Type Description
autoUpgradePolicy

Zasady automatycznego uaktualniania zasobów usługi Cosmos DB

maxThroughput
  • integer

Reprezentuje maksymalny kontener przepływności, który można skalować w górę.

targetMaxThroughput
  • integer

Reprezentuje docelowy kontener maksymalnej przepływności można skalować w górę do momentu, gdy oferta nie jest już w stanie oczekiwania.

AutoUpgradePolicyResource

Zasady automatycznego uaktualniania zasobów usługi Cosmos DB

Name Type Description
throughputPolicy

Reprezentuje zasady przepływności, które usługa musi być zgodna z zasadami automatycznego uaktualniania

ManagedServiceIdentity

Tożsamość zasobu.

Name Type Description
principalId
  • string

Identyfikator podmiotu zabezpieczeń tożsamości przypisanej przez system. Ta właściwość zostanie udostępniona tylko dla tożsamości przypisanej przez system.

tenantId
  • string

Identyfikator dzierżawy tożsamości przypisanej przez system. Ta właściwość zostanie udostępniona tylko dla tożsamości przypisanej przez system.

type

Typ tożsamości używanej dla zasobu. Typ "SystemAssigned,UserAssigned" zawiera zarówno niejawnie utworzoną tożsamość, jak i zestaw tożsamości przypisanych przez użytkownika. Typ "Brak" spowoduje usunięcie wszystkich tożsamości z usługi.

userAssignedIdentities

Lista tożsamości użytkowników skojarzonych z zasobem. Odwołania do klucza słownika tożsamości użytkownika będą identyfikatorami zasobów usługi ARM w postaci: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}".

Resource

Name Type Description
_etag
  • string

Właściwość wygenerowana przez system reprezentująca tag zasobu wymagany do optymistycznej kontroli współbieżności.

_rid
  • string

Właściwość wygenerowana przez system. Unikatowy identyfikator.

_ts
  • number

Właściwość wygenerowana przez system, która określa ostatnio zaktualizowany znacznik czasu zasobu.

autoscaleSettings

Zasób usługi Cosmos DB dla ustawień skalowania automatycznego. Wymagana jest przepływność lub autoskalowanieUstawienia jest wymagane, ale nie oba.

minimumThroughput
  • string

Minimalna przepływność zasobu

offerReplacePending
  • string

Oczekiwanie na zastąpienie przepływności

throughput
  • integer

Wartość przepływności zasobów usługi Cosmos DB. Wymagana jest przepływność lub autoskalowanieUstawienia jest wymagane, ale nie oba.

ResourceIdentityType

Typ tożsamości używanej dla zasobu. Typ "SystemAssigned,UserAssigned" zawiera zarówno niejawnie utworzoną tożsamość, jak i zestaw tożsamości przypisanych przez użytkownika. Typ "Brak" spowoduje usunięcie wszystkich tożsamości z usługi.

Name Type Description
None
  • string
SystemAssigned
  • string
SystemAssigned,UserAssigned
  • string
UserAssigned
  • string

ThroughputPolicyResource

Zasady przepływności zasobów usługi Cosmos DB

Name Type Description
incrementPercent
  • integer

Reprezentuje wartość procentową, za pomocą której przepływność może zwiększać się za każdym razem, gdy zasady przepływności są uruchamiane.

isEnabled
  • boolean

Określa, czy element ThroughputPolicy jest aktywny, czy nie

ThroughputSettingsGetResults

Przepływność zasobów usługi Azure Cosmos DB.

Name Type Description
id
  • string

Unikatowy identyfikator zasobu usługi ARM.

identity

Tożsamość zasobu.

location
  • string

Lokalizacja grupy zasobów, do której należy zasób.

name
  • string

Nazwa zasobu usługi ARM.

properties.resource
tags
  • object

Tagi to lista par klucz-wartość, które opisują zasób. Te tagi mogą służyć do wyświetlania i grupowania tego zasobu (między grupami zasobów). Dla zasobu można podać maksymalnie 15 tagów. Każdy tag musi mieć klucz nie większy niż 128 znaków i wartość nie większą niż 256 znaków. Na przykład domyślne środowisko dla typu szablonu jest ustawiane z wartością "defaultExperience": "Cassandra". Bieżące wartości "defaultExperience" obejmują również wartości "Table", "Graph", "DocumentDB" i "MongoDB".

type
  • string

Typ zasobu platformy Azure.

ThroughputSettingsResource

Obiekt przepływności zasobów usługi Cosmos DB. Wymagana jest przepływność lub autoskalowanieUstawienia jest wymagane, ale nie oba.

Name Type Description
autoscaleSettings

Zasób usługi Cosmos DB dla ustawień skalowania automatycznego. Wymagana jest przepływność lub autoskalowanieUstawienia jest wymagane, ale nie oba.

minimumThroughput
  • string

Minimalna przepływność zasobu

offerReplacePending
  • string

Oczekiwanie na zastąpienie przepływności

throughput
  • integer

Wartość przepływności zasobów usługi Cosmos DB. Wymagana jest przepływność lub autoskalowanieUstawienia jest wymagane, ale nie oba.

ThroughputSettingsUpdateParameters

Parametry do aktualizowania przepływności zasobów usługi Cosmos DB.

Name Type Description
id
  • string

Unikatowy identyfikator zasobu usługi ARM.

identity

Tożsamość zasobu.

location
  • string

Lokalizacja grupy zasobów, do której należy zasób.

name
  • string

Nazwa zasobu usługi ARM.

properties.resource

Standardowy format JSON przepływności zasobów

tags
  • object

Tagi to lista par klucz-wartość, które opisują zasób. Te tagi mogą służyć do wyświetlania i grupowania tego zasobu (między grupami zasobów). Dla zasobu można podać maksymalnie 15 tagów. Każdy tag musi mieć klucz nie większy niż 128 znaków i wartość nie większą niż 256 znaków. Na przykład domyślne środowisko dla typu szablonu jest ustawiane z wartością "defaultExperience": "Cassandra". Bieżące wartości "defaultExperience" obejmują również wartości "Table", "Graph", "DocumentDB" i "MongoDB".

type
  • string

Typ zasobu platformy Azure.

UserAssignedIdentities

Lista tożsamości użytkowników skojarzonych z zasobem. Odwołania do klucza słownika tożsamości użytkownika będą identyfikatorami zasobów usługi ARM w postaci: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}".

Name Type Description