Sims - Create Or Update

Başvuru

Service:: Mobile Network

API Version:: 2024-04-01

SIM oluşturur veya güncelleştirir.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MobileNetwork/simGroups/{simGroupName}/sims/{simName}?api-version=2024-04-01

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
resourceGroupName	path	True	string	Kaynak grubunun adı. Ad büyük/küçük harfe duyarlı değildir.
simGroupName	path	True	string	SIM Grubunun adı. Regex pattern: `^[a-zA-Z0-9][a-zA-Z0-9_-]*$`
simName	path	True	string	SIM'in adı. Regex pattern: `^[a-zA-Z0-9][a-zA-Z0-9_-]*$`
subscriptionId	path	True	string uuid	Hedef aboneliğin kimliği. Değer bir UUID olmalıdır.
api-version	query	True	string	Bu işlem için kullanılacak API sürümü.

İstek Gövdesi

Name	Gerekli	Tür	Description
properties.internationalMobileSubscriberIdentity	True	string	SIM için uluslararası mobil abone kimliği (IMSI).
properties.authenticationKey		string	SIM için Ki değeri.
properties.deviceType		string	Bu SIM'in ilişkili olduğu cihaz türünü kaydetmek için kullanılabilen isteğe bağlı bir serbest biçimli metin alanı, örneğin 'Video kamera'. Azure portal, SIM'lerin bu değere göre gruplandırılmasını ve filtrelenmiş olmasını sağlar.
properties.integratedCircuitCardIdentifier		string	SIM kart için entegre devre kartı kimliği (ICCID).
properties.operatorKeyCode		string	SIM için Opc değeri.
properties.simPolicy		SimPolicyResourceId	Bu SIM tarafından kullanılan SIM ilkesi. SIM ilkesi SIM ile aynı konumda olmalıdır.
properties.staticIpConfiguration		SimStaticIpProperties[]	Bu SIM'e atanmış statik IP adreslerinin listesi. Her adres, {bağlı veri ağı, dilim} öğesinden oluşan tanımlı bir ağ kapsamında atanır.

Yanıtlar

Name	Tür	Description
200 OK	Sim	Güncelleştirme başarılı oldu. İşlem, sonuçta elde edilen SIM kaynağını döndürür.
201 Created	Sim	İçerik Oluşturucu başarılı. İşlem, sonuçta elde edilen SIM kaynağını döndürür.
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 Flow.

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

Scopes

Name	Description
user_impersonation	kullanıcı hesabınızın kimliğine bürünme

Örnekler

Create SIM

Sample Request

HTTP

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"
        }
      }
    ]
  }
}

Sample Response

Status code:: 200

{
  "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"
        }
      }
    ]
  }
}

Status code:: 201

Azure-AsyncOperation: https://management.azure.com/providers/Microsoft.MobileNetwork/locations/testLocation/operationStatuses/testOperation?api-version=2024-04-01

Response Body

{
  "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"
        }
      }
    ]
  }
}

Tanımlar

Name	Description
AttachedDataNetworkResourceId	Ekli veri ağı kaynağına başvuru.
createdByType	Kaynağı oluşturan kimliğin türü.
ErrorAdditionalInfo	Kaynak yönetimi hatası ek bilgileri.
ErrorDetail	Hata ayrıntısı.
ErrorResponse	Hata yanıtı
ProvisioningState	Geçerli sağlama durumu.
Sim	SIM kaynağı.
SimPolicyResourceId	SIM ilkesi kaynağına başvuru.
SimState	SIM kaynağının durumu.
SimStaticIpProperties	Belirli bir ekli veri ağı ve dilimi kapsamındaki bir SIM için statik IP yapılandırması.
SliceResourceId	Dilim kaynağına başvuru.
StaticIp	SIM'in tanımlı ağ kapsamında kullanması için statik IP yapılandırması.
systemData	Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.

AttachedDataNetworkResourceId

Ekli veri ağı kaynağına başvuru.

Name	Tür	Description
id	string	Ekli veri ağı kaynak kimliği.

createdByType

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

Name	Tür	Description
Application	string
Key	string
ManagedIdentity	string
User	string

ErrorAdditionalInfo

Kaynak yönetimi hatası ek bilgileri.

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

ErrorDetail

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

Hata yanıtı

Name	Tür	Description
error	ErrorDetail	Hata nesnesi.

ProvisioningState

Geçerli sağlama durumu.

Name	Tür	Description
Accepted	string
Canceled	string
Deleted	string
Deleting	string
Failed	string
Succeeded	string
Unknown	string

Sim

SIM kaynağı.

Name	Tür	Description
id	string	Kaynağın tam kaynak kimliği. Örneğin, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Kaynağın adı
properties.authenticationKey	string	SIM için Ki değeri.
properties.deviceType	string	Bu SIM'in ilişkili olduğu cihaz türünü kaydetmek için kullanılabilen isteğe bağlı bir serbest biçimli metin alanı, örneğin 'Video kamera'. Azure portal, SIM'lerin bu değere göre gruplandırılmasını ve filtrelenmiş olmasını sağlar.
properties.integratedCircuitCardIdentifier	string	SIM kart için entegre devre kartı kimliği (ICCID).
properties.internationalMobileSubscriberIdentity	string	SIM için uluslararası mobil abone kimliği (IMSI).
properties.operatorKeyCode	string	SIM için Opc değeri.
properties.provisioningState	ProvisioningState	SIM kaynağının sağlama durumu.
properties.simPolicy	SimPolicyResourceId	Bu SIM tarafından kullanılan SIM ilkesi. SIM ilkesi SIM ile aynı konumda olmalıdır.
properties.simState	SimState	SIM kaynağının durumu.
properties.siteProvisioningState	object	Sitelerde bu SIM'in sağlama durumuna yönelik bir site sözlüğü.
properties.staticIpConfiguration	SimStaticIpProperties[]	Bu SIM'e atanmış statik IP adreslerinin listesi. Her adres, {bağlı veri ağı, dilim} öğesinden oluşan tanımlı bir ağ kapsamında atanır.
properties.vendorKeyFingerprint	string	Varsa, bu SIM'i sağlayan SIM satıcısının ortak anahtar parmak izi.
properties.vendorName	string	Varsa, bu SIM'i sağlayan SIM satıcısının adı.
systemData	systemData	Azure Resource Manager createdBy ve modifiedBy bilgilerini içeren meta veriler.
type	string	Kaynağın türü. Örneğin, "Microsoft.Compute/virtualMachines" veya "Microsoft.Storage/storageAccounts"

SimPolicyResourceId

SIM ilkesi kaynağına başvuru.

Name	Tür	Description
id	string	SIM ilkesi kaynak kimliği.

SimState

SIM kaynağının durumu.

Name	Tür	Description
Disabled	string	Etkinleştirme için gereken tüm yapılandırma mevcut olmadığından SIM devre dışı bırakıldı.
Enabled	string	SIM etkindir.
Invalid	string	İlişkili yapılandırmalardan bazıları geçersiz olduğundan SIM etkinleştirilemiyor.

SimStaticIpProperties

Belirli bir ekli veri ağı ve dilimi kapsamındaki bir SIM için statik IP yapılandırması.

Name	Tür	Description
attachedDataNetwork	AttachedDataNetworkResourceId	Statik IP adresinin kullanılacağı ekli veri ağı. Ekli veri ağı ve dilim birleşimi, IP adresinin ağ kapsamını tanımlar. Ekli veri ağı SIM ile aynı konumda olmalıdır.
slice	SliceResourceId	Statik IP adresinin kullanılacağı ağ dilimi. Ekli veri ağı ve dilim birleşimi, IP adresinin ağ kapsamını tanımlar. Dilimin SIM ile aynı konumda olması gerekir.
staticIp	StaticIp	SIM'in tanımlı ağ kapsamında kullanması için statik IP yapılandırması.

SliceResourceId

Dilim kaynağına başvuru.

Name	Tür	Description
id	string	Dilim kaynağı kimliği.

StaticIp

SIM'in tanımlı ağ kapsamında kullanması için statik IP yapılandırması.

Name	Tür	Description
ipv4Address	string	Bu ağ kapsamında SIM'e atanan IPv4 adresi. Bu adres, ekli veri ağında tanımlanan userEquipmentStaticAddressPoolPrefix içinde olmalıdır.

systemData

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

Name	Tür	Description
createdAt	string	Kaynak oluşturma (UTC) zaman damgası.
createdBy	string	Kaynağı oluşturan kimlik.
createdByType	createdByType	Kaynağı oluşturan kimliğin türü.
lastModifiedAt	string	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 kimliğin türü.

Aracılığıyla paylaş