Mongo DB Resources - Update Mongo DB Database Throughput
Aktualizowanie jednostek RU na sekundę bazy danych MongoDB usługi Azure Cosmos DB
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/mongodbDatabases/{databaseName}/throughputSettings/default?api-version=2023-11-15
Parametry identyfikatora URI
Nazwa | W | Wymagane | Typ | Opis |
---|---|---|---|---|
account
|
path | True |
string |
Nazwa konta bazy danych usługi Cosmos DB. Regex pattern: |
database
|
path | True |
string |
Nazwa bazy danych usługi Cosmos DB. |
resource
|
path | True |
string |
Nazwa grupy zasobów. W nazwie jest uwzględniana wielkość liter. |
subscription
|
path | True |
string |
Identyfikator subskrypcji docelowej. |
api-version
|
query | True |
string |
Wersja interfejsu API do użycia dla tej operacji. |
Treść żądania
Nazwa | Typ | Opis |
---|---|---|
updateThroughputParameters |
Jednostki RU na sekundę parametrów, które mają być podane dla bieżącej bazy danych MongoDB. |
Odpowiedzi
Nazwa | Typ | Opis |
---|---|---|
200 OK |
Liczba jednostek RU na sekundę operacji aktualizacji bazy danych MongoDB została ukończona pomyślnie. |
|
202 Accepted |
Jednostki RU na sekundę operacji aktualizacji bazy danych MongoDB zostaną ukończone asynchronicznie. Headers
|
|
Other Status Codes |
Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się. |
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
Nazwa | Opis |
---|---|
user_impersonation | Personifikuj konto użytkownika |
Przykłady
CosmosDBMongoDBDatabaseThroughputUpdate
Sample Request
PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1/mongodbDatabases/databaseName/throughputSettings/default?api-version=2023-11-15
{
"location": "West US",
"tags": {},
"properties": {
"resource": {
"throughput": 400
}
}
}
Sample Response
{
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1/mongodbDatabases/databaseName/throughputSettings/default",
"name": "default",
"type": "Microsoft.DocumentDB/databaseAccounts/mongodbDatabases/throughputSettings",
"location": "West US",
"tags": {},
"properties": {
"resource": {
"throughput": 400,
"minimumThroughput": "400",
"offerReplacePending": "true",
"_rid": "PD5DALigDgw=",
"_ts": 1459200611,
"_etag": "\"00005900-0000-0000-0000-56f9a2630000\""
}
}
}
Definicje
Nazwa | Opis |
---|---|
Autoscale |
Obiekt ustawień aprowizowanej przepływności usługi Cosmos DB |
Auto |
Zasady automatycznego uaktualniania zasobów usługi Cosmos DB |
Cloud |
Odpowiedź na błąd z usługi. |
Error |
Odpowiedź na błąd. |
Resource | |
Throughput |
Zasady przepływności zasobów usługi Cosmos DB |
Throughput |
Przepływność zasobów usługi Azure Cosmos DB. |
Throughput |
Obiekt przepływności zasobów usługi Cosmos DB. Wymagana jest przepływność lub autoskalowanieUstawienia jest wymagane, ale nie oba. |
Throughput |
Jednostki RU na sekundę parametrów, które mają być podane dla bieżącej bazy danych MongoDB. |
AutoscaleSettingsResource
Obiekt ustawień aprowizowanej przepływności usługi Cosmos DB
Nazwa | Typ | Opis |
---|---|---|
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
Nazwa | Typ | Opis |
---|---|---|
throughputPolicy |
Reprezentuje zasady przepływności, które usługa musi być zgodna z zasadami automatycznego uaktualniania |
CloudError
Odpowiedź na błąd z usługi.
Nazwa | Typ | Opis |
---|---|---|
error |
Odpowiedź na błąd. |
ErrorResponse
Odpowiedź na błąd.
Nazwa | Typ | Opis |
---|---|---|
code |
string |
Kod błędu. |
message |
string |
Komunikat o błędzie wskazujący, dlaczego operacja nie powiodła się. |
Resource
Nazwa | Typ | Opis |
---|---|---|
_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. |
|
instantMaximumThroughput |
string |
Wartość przepływności oferty do natychmiastowego skalowania w górę bez wyzwalania podziałów |
minimumThroughput |
string |
Minimalna przepływność zasobu |
offerReplacePending |
string |
Oczekiwanie na zastąpienie przepływności |
softAllowedMaximumThroughput |
string |
Maksymalna wartość przepływności lub maksymalna wartość maxThroughput (dla autoskalowania), którą można określić |
throughput |
integer |
Wartość przepływności zasobów usługi Cosmos DB. Wymagana jest przepływność lub autoskalowanieUstawienia jest wymagane, ale nie oba. |
ThroughputPolicyResource
Zasady przepływności zasobów usługi Cosmos DB
Nazwa | Typ | Opis |
---|---|---|
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.
Nazwa | Typ | Opis |
---|---|---|
id |
string |
Unikatowy identyfikator zasobu usługi ARM. |
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.
Nazwa | Typ | Opis |
---|---|---|
autoscaleSettings |
Zasób usługi Cosmos DB dla ustawień skalowania automatycznego. Wymagana jest przepływność lub autoskalowanieUstawienia jest wymagane, ale nie oba. |
|
instantMaximumThroughput |
string |
Wartość przepływności oferty do natychmiastowego skalowania w górę bez wyzwalania podziałów |
minimumThroughput |
string |
Minimalna przepływność zasobu |
offerReplacePending |
string |
Oczekiwanie na zastąpienie przepływności |
softAllowedMaximumThroughput |
string |
Maksymalna wartość przepływności lub maksymalna wartość maxThroughput (dla autoskalowania), którą można określić |
throughput |
integer |
Wartość przepływności zasobów usługi Cosmos DB. Wymagana jest przepływność lub autoskalowanieUstawienia jest wymagane, ale nie oba. |
ThroughputSettingsUpdateParameters
Jednostki RU na sekundę parametrów, które mają być podane dla bieżącej bazy danych MongoDB.
Nazwa | Typ | Opis |
---|---|---|
id |
string |
Unikatowy identyfikator zasobu usługi ARM. |
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. |