Sims - Create Or Update
Tworzy lub aktualizuje kartę SIM.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MobileNetwork/simGroups/{simGroupName}/sims/{simName}?api-version=2024-04-01
Parametry identyfikatora URI
Nazwa | W | Wymagane | Typ | Opis |
---|---|---|---|---|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter. |
sim
|
path | True |
string maxLength: 64pattern: ^[a-zA-Z0-9][a-zA-Z0-9_-]*$ |
Nazwa grupy SIM. |
sim
|
path | True |
string maxLength: 64pattern: ^[a-zA-Z0-9][a-zA-Z0-9_-]*$ |
Nazwa karty SIM. |
subscription
|
path | True |
string (uuid) |
Identyfikator subskrypcji docelowej. Wartość musi być identyfikatorem UUID. |
api-version
|
query | True |
string minLength: 1 |
Wersja interfejsu API do użycia dla tej operacji. |
Treść żądania
Nazwa | Wymagane | Typ | Opis |
---|---|---|---|
properties.internationalMobileSubscriberIdentity | True |
string pattern: ^[0-9]{5,15}$ |
Międzynarodowa tożsamość subskrybenta urządzeń przenośnych (IMSI) dla karty SIM. |
properties.authenticationKey |
string pattern: ^[0-9a-fA-F]{32}$ |
Wartość Ki dla karty SIM. |
|
properties.deviceType |
string |
Opcjonalne pole tekstowe w dowolnej formie, które może służyć do rejestrowania typu urządzenia, z którą jest skojarzona ta karta SIM, na przykład "Kamera wideo". Witryna Azure Portal umożliwia grupowanie i filtrowanie sim na podstawie tej wartości. |
|
properties.integratedCircuitCardIdentifier |
string pattern: ^[0-9]{10,20}$ |
Identyfikator karty obwodu zintegrowanego (ICCID) dla karty SIM. |
|
properties.operatorKeyCode |
string pattern: ^[0-9a-fA-F]{32}$ |
Wartość Opc dla karty SIM. |
|
properties.simPolicy |
Zasady sim używane przez tę kartę SIM. Zasady sim muszą znajdować się w tej samej lokalizacji co karta SIM. |
||
properties.staticIpConfiguration |
Lista statycznych adresów IP przypisanych do tej karty SIM. Każdy adres jest przypisywany w zdefiniowanym zakresie sieciowym składającym się z {dołączonej sieci danych, fragmentatora}. |
Odpowiedzi
Nazwa | Typ | Opis |
---|---|---|
200 OK |
Aktualizacja powiodła się. Operacja zwraca wynikowy zasób SIM. |
|
201 Created |
Tworzenie powiodło się. Operacja zwraca wynikowy zasób SIM. |
|
Other Status Codes |
Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się. |
Zabezpieczenia
azure_auth
Przepływ protokołu OAuth2 usługi Azure Active Directory.
Typ:
oauth2
Flow:
implicit
Adres URL autoryzacji:
https://login.microsoftonline.com/common/oauth2/authorize
Zakresy
Nazwa | Opis |
---|---|
user_impersonation | personifikacja konta użytkownika |
Przykłady
Create SIM
Przykładowe żądanie
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/simGroups/testSimGroup/sims/testSim?api-version=2024-04-01
{
"properties": {
"integratedCircuitCardIdentifier": "8900000000000000000",
"internationalMobileSubscriberIdentity": "00000",
"authenticationKey": "00000000000000000000000000000000",
"operatorKeyCode": "00000000000000000000000000000000",
"deviceType": "Video camera",
"simPolicy": {
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/simPolicies/MySimPolicy"
},
"staticIpConfiguration": [
{
"attachedDataNetwork": {
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/packetCoreControlPlanes/TestPacketCoreCP/packetCoreDataPlanes/TestPacketCoreDP/attachedDataNetworks/TestAttachedDataNetwork"
},
"slice": {
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/slices/testSlice"
},
"staticIp": {
"ipv4Address": "2.4.0.1"
}
}
]
}
}
Przykładowa odpowiedź
{
"name": "testSim",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/simGroups/testSimGroup/sims/testSim",
"type": "Microsoft.MobileNetwork/simGroups/sims",
"systemData": {
"createdBy": "user1",
"createdByType": "User",
"createdAt": "2020-01-01T17:18:19.1234567Z",
"lastModifiedBy": "user2",
"lastModifiedByType": "User",
"lastModifiedAt": "2020-01-02T17:18:19.1234567Z"
},
"properties": {
"provisioningState": "Succeeded",
"simState": "Enabled",
"siteProvisioningState": {
"/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/sites/testSite": "Provisioned",
"/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/sites/testSite2": "Provisioned"
},
"integratedCircuitCardIdentifier": "8900000000000000000",
"internationalMobileSubscriberIdentity": "00000",
"deviceType": "Video camera",
"simPolicy": {
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/simPolicies/MySimPolicy"
},
"staticIpConfiguration": [
{
"attachedDataNetwork": {
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/packetCoreControlPlanes/TestPacketCoreCP/packetCoreDataPlanes/TestPacketCoreDP/attachedDataNetworks/TestAttachedDataNetwork"
},
"slice": {
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/slices/testSlice"
},
"staticIp": {
"ipv4Address": "2.4.0.1"
}
}
]
}
}
Azure-AsyncOperation: https://management.azure.com/providers/Microsoft.MobileNetwork/locations/testLocation/operationStatuses/testOperation?api-version=2024-04-01
{
"name": "testSim",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/simGroups/testSimGroup/sims/testSim",
"type": "Microsoft.MobileNetwork/simGroups/sims",
"systemData": {
"createdBy": "user1",
"createdByType": "User",
"createdAt": "2020-01-01T17:18:19.1234567Z",
"lastModifiedBy": "user2",
"lastModifiedByType": "User",
"lastModifiedAt": "2020-01-02T17:18:19.1234567Z"
},
"properties": {
"provisioningState": "Created",
"simState": "Enabled",
"siteProvisioningState": {
"/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/sites/testSite": "Adding",
"/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/sites/testSite2": "Adding"
},
"integratedCircuitCardIdentifier": "8900000000000000000",
"internationalMobileSubscriberIdentity": "00000",
"deviceType": "Video camera",
"simPolicy": {
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/simPolicies/MySimPolicy"
},
"staticIpConfiguration": [
{
"attachedDataNetwork": {
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/packetCoreControlPlanes/TestPacketCoreCP/packetCoreDataPlanes/TestPacketCoreDP/attachedDataNetworks/TestAttachedDataNetwork"
},
"slice": {
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/slices/testSlice"
},
"staticIp": {
"ipv4Address": "2.4.0.1"
}
}
]
}
}
Definicje
Nazwa | Opis |
---|---|
Attached |
Odwołanie do dołączonego zasobu sieciowego danych. |
created |
Typ tożsamości, która utworzyła zasób. |
Error |
Dodatkowe informacje o błędzie zarządzania zasobami. |
Error |
Szczegóły błędu. |
Error |
Odpowiedź na błąd |
Provisioning |
Bieżący stan aprowizacji. |
Sim |
Zasób SIM. |
Sim |
Odwołanie do zasobu zasad SIM. |
Sim |
Stan zasobu SIM. |
Sim |
Statyczna konfiguracja adresu IP dla karty SIM, w zakresie określonej dołączonej sieci danych i wycinka. |
Slice |
Odwołanie do zasobu fragmentatora. |
Static |
Konfiguracja statycznego adresu IP dla karty SIM do użycia w zdefiniowanym zakresie sieci. |
system |
Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu. |
AttachedDataNetworkResourceId
Odwołanie do dołączonego zasobu sieciowego danych.
Nazwa | Typ | Opis |
---|---|---|
id |
string pattern: ^/[sS][uU][bB][sS][cC][rR][iI][pP][tT][iI][oO][nN][sS]/[^/?#]+/[rR][eE][sS][oO][uU][rR][cC][eE][gG][rR][oO][uU][pP][sS]/[^/?#]+/[pP][rR][oO][vV][iI][dD][eE][rR][sS]/[mM][iI][cC][rR][oO][sS][oO][fF][tT]\.[mM][oO][bB][iI][lL][eE][nN][eE][tT][wW][oO][rR][kK]/[pP][aA][cC][kK][eE][tT][cC][oO][rR][eE][cC][oO][nN][tT][rR][oO][lL][pP][lL][aA][nN][eE][sS]/[^/?#]+/[pP][aA][cC][kK][eE][tT][cC][oO][rR][eE][dD][aA][tT][aA][pP][lL][aA][nN][eE][sS]/[^/?#]+/[aA][tT][tT][aA][cC][hH][eE][dD][dD][aA][tT][aA][nN][eE][tT][wW][oO][rR][kK][sS]/[^/?#]+$ |
Identyfikator zasobu sieciowego dołączonych danych. |
createdByType
Typ tożsamości, która utworzyła zasób.
Wartość | Opis |
---|---|
Application | |
Key | |
ManagedIdentity | |
User |
ErrorAdditionalInfo
Dodatkowe informacje o błędzie zarządzania zasobami.
Nazwa | Typ | Opis |
---|---|---|
info |
object |
Dodatkowe informacje. |
type |
string |
Dodatkowy typ informacji. |
ErrorDetail
Szczegóły błędu.
Nazwa | Typ | Opis |
---|---|---|
additionalInfo |
Dodatkowe informacje o błędzie. |
|
code |
string |
Kod błędu. |
details |
Szczegóły błędu. |
|
message |
string |
Komunikat o błędzie. |
target |
string |
Element docelowy błędu. |
ErrorResponse
Odpowiedź na błąd
Nazwa | Typ | Opis |
---|---|---|
error |
Obiekt błędu. |
ProvisioningState
Bieżący stan aprowizacji.
Wartość | Opis |
---|---|
Accepted | |
Canceled | |
Deleted | |
Deleting | |
Failed | |
Succeeded | |
Unknown |
Sim
Zasób SIM.
Nazwa | Typ | Opis |
---|---|---|
id |
string (arm-id) |
W pełni kwalifikowany identyfikator zasobu dla zasobu. Np. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
name |
string |
Nazwa zasobu |
properties.authenticationKey |
string pattern: ^[0-9a-fA-F]{32}$ |
Wartość Ki dla karty SIM. |
properties.deviceType |
string |
Opcjonalne pole tekstowe w dowolnej formie, które może służyć do rejestrowania typu urządzenia, z którą jest skojarzona ta karta SIM, na przykład "Kamera wideo". Witryna Azure Portal umożliwia grupowanie i filtrowanie sim na podstawie tej wartości. |
properties.integratedCircuitCardIdentifier |
string pattern: ^[0-9]{10,20}$ |
Identyfikator karty obwodu zintegrowanego (ICCID) dla karty SIM. |
properties.internationalMobileSubscriberIdentity |
string pattern: ^[0-9]{5,15}$ |
Międzynarodowa tożsamość subskrybenta urządzeń przenośnych (IMSI) dla karty SIM. |
properties.operatorKeyCode |
string pattern: ^[0-9a-fA-F]{32}$ |
Wartość Opc dla karty SIM. |
properties.provisioningState |
Stan aprowizacji zasobu SIM. |
|
properties.simPolicy |
Zasady sim używane przez tę kartę SIM. Zasady sim muszą znajdować się w tej samej lokalizacji co karta SIM. |
|
properties.simState |
Stan zasobu SIM. |
|
properties.siteProvisioningState |
object |
Słownik witryn do stanu aprowizacji tej karty SIM w tej witrynie. |
properties.staticIpConfiguration |
Lista statycznych adresów IP przypisanych do tej karty SIM. Każdy adres jest przypisywany w zdefiniowanym zakresie sieciowym składającym się z {dołączonej sieci danych, fragmentatora}. |
|
properties.vendorKeyFingerprint |
string |
Odcisk palca klucza publicznego dostawcy SIM, który dostarczył tę kartę SIM, jeśli istnieje. |
properties.vendorName |
string |
Nazwa dostawcy sim, który dostarczył tę kartę SIM, jeśli istnieje. |
systemData |
Metadane usługi Azure Resource Manager zawierające informacje createdBy i modifiedBy. |
|
type |
string |
Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft.Storage/storageAccounts" |
SimPolicyResourceId
Odwołanie do zasobu zasad SIM.
Nazwa | Typ | Opis |
---|---|---|
id |
string pattern: ^/[sS][uU][bB][sS][cC][rR][iI][pP][tT][iI][oO][nN][sS]/[^/?#]+/[rR][eE][sS][oO][uU][rR][cC][eE][gG][rR][oO][uU][pP][sS]/[^/?#]+/[pP][rR][oO][vV][iI][dD][eE][rR][sS]/[mM][iI][cC][rR][oO][sS][oO][fF][tT]\.[mM][oO][bB][iI][lL][eE][nN][eE][tT][wW][oO][rR][kK]/[mM][oO][bB][iI][lL][eE][nN][eE][tT][wW][oO][rR][kK][sS]/[^/?#]+/[sS][iI][mM][pP][oO][lL][iI][cC][iI][eE][sS]/[^/?#]+$ |
Identyfikator zasobu zasad SIM. |
SimState
Stan zasobu SIM.
Wartość | Opis |
---|---|
Disabled |
Karta SIM jest wyłączona, ponieważ nie wszystkie konfiguracje wymagane do włączenia są obecne. |
Enabled |
Karta SIM jest włączona. |
Invalid |
Nie można włączyć karty SIM, ponieważ część skojarzonej konfiguracji jest nieprawidłowa. |
SimStaticIpProperties
Statyczna konfiguracja adresu IP dla karty SIM, w zakresie określonej dołączonej sieci danych i wycinka.
Nazwa | Typ | Opis |
---|---|---|
attachedDataNetwork |
Dołączona sieć danych, w której będzie używany statyczny adres IP. Kombinacja dołączonej sieci danych i wycinek definiuje zakres sieci adresu IP. Dołączona sieć danych musi znajdować się w tej samej lokalizacji co karta SIM. |
|
slice |
Wycinek sieci, na którym będzie używany statyczny adres IP. Kombinacja dołączonej sieci danych i wycinek definiuje zakres sieci adresu IP. Wycinek musi znajdować się w tej samej lokalizacji co karta SIM. |
|
staticIp |
Konfiguracja statycznego adresu IP dla karty SIM do użycia w zdefiniowanym zakresie sieci. |
SliceResourceId
Odwołanie do zasobu fragmentatora.
Nazwa | Typ | Opis |
---|---|---|
id |
string pattern: ^/[sS][uU][bB][sS][cC][rR][iI][pP][tT][iI][oO][nN][sS]/[^/?#]+/[rR][eE][sS][oO][uU][rR][cC][eE][gG][rR][oO][uU][pP][sS]/[^/?#]+/[pP][rR][oO][vV][iI][dD][eE][rR][sS]/[mM][iI][cC][rR][oO][sS][oO][fF][tT]\.[mM][oO][bB][iI][lL][eE][nN][eE][tT][wW][oO][rR][kK]/[mM][oO][bB][iI][lL][eE][nN][eE][tT][wW][oO][rR][kK][sS]/[^/?#]+/[sS][lL][iI][cC][eE][sS]/[^/?#]+$ |
Identyfikator zasobu fragmentatora. |
StaticIp
Konfiguracja statycznego adresu IP dla karty SIM do użycia w zdefiniowanym zakresie sieci.
Nazwa | Typ | Opis |
---|---|---|
ipv4Address |
string pattern: ^(([0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])\.){3}([0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])$ |
Adres IPv4 przypisany do karty SIM w tym zakresie sieci. Ten adres musi znajdować się w elemecie userEquipmentStaticAddressPoolPrefix zdefiniowanym w dołączonej sieci danych. |
systemData
Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.
Nazwa | Typ | Opis |
---|---|---|
createdAt |
string (date-time) |
Sygnatura czasowa tworzenia zasobu (UTC). |
createdBy |
string |
Tożsamość, która utworzyła zasób. |
createdByType |
Typ tożsamości, która utworzyła zasób. |
|
lastModifiedAt |
string (date-time) |
Znacznik czasu ostatniej modyfikacji zasobu (UTC) |
lastModifiedBy |
string |
Tożsamość, która ostatnio zmodyfikowała zasób. |
lastModifiedByType |
Typ tożsamości, która ostatnio zmodyfikowała zasób. |