MS Graph Grupları ve Kullanıcıları
MS Graph Grupları ve Kullanıcıları bağlayıcısı Microsoft Entra Id gruplarını, üyeleri (kullanıcıları) ve lisans ayrıntılarını almaya yardımcı olur
Bu bağlayıcı aşağıdaki ürün ve bölgelerde kullanılabilir:
| Hizmet | Class | Bölgeler |
|---|---|---|
| Copilot Studio | Premium | Aşağıdakiler dışında tüm Power Automate bölgeleri : - ABD Kamu (GCC) - US Government (GCC High) - 21Vianet tarafından işletilen Çin Bulutu - ABD Savunma Bakanlığı (DoD) |
| Logic Apps | Standart | Aşağıdakiler dışında tüm Logic Apps bölgeleri : - Azure Kamu bölgeleri - Azure Çin bölgeleri - ABD Savunma Bakanlığı (DoD) |
| Power Apps | Premium | Aşağıdakiler dışında tüm Power Apps bölgeleri : - ABD Kamu (GCC) - US Government (GCC High) - 21Vianet tarafından işletilen Çin Bulutu - ABD Savunma Bakanlığı (DoD) |
| Power Automate | Premium | Aşağıdakiler dışında tüm Power Automate bölgeleri : - ABD Kamu (GCC) - US Government (GCC High) - 21Vianet tarafından işletilen Çin Bulutu - ABD Savunma Bakanlığı (DoD) |
| İletişim | |
|---|---|
| İsim | Jay Jani, Microsoft |
| E-posta | jayjani@microsoft.com |
| Bağlayıcı Meta Verileri | |
|---|---|
| Publisher | Jay Jani |
| Web sitesi | https://graph.microsoft.com |
| Gizlilik ilkesi | https://privacy.microsoft.com/en-us/privacystatement |
| Kategoriler | BT İşlemleri; Veri |
Bağlantı oluşturma
Bağlayıcı aşağıdaki kimlik doğrulama türlerini destekler:
| Varsayılan | Bağlantı oluşturmak için parametreler. | Tüm bölgeler | Paylaşılamaz |
Temerrüt
Geçerli: Tüm bölgeler
Bağlantı oluşturmak için parametreler.
Bu, paylaşılabilir bir bağlantı değildir. Power app başka bir kullanıcıyla paylaşılıyorsa, başka bir kullanıcıdan açıkça yeni bağlantı oluşturması istenir.
Azaltma Sınırları
| Name | Çağrılar | Yenileme Dönemi |
|---|---|---|
| Bağlantı başına API çağrıları | 100 | 60 saniye |
Eylemler
| Abone Olunan Sku'ları Listeleme |
Kuruluşun abone olunan lisans planı SKU'larının ayrıntıları |
| Doğrudan Grup Üyelerini Listeleme |
Sayıyla bir grubun doğrudan üyelerini alma |
| Grup Özelliklerini Alma |
Microsoft Entra Id grubunun özelliklerini ve ilişkilerini alma |
| Grupları Görünen Ad Arama ölçütüne göre listele |
Grubun görünen adını arayarak grupları alma |
| Kullanıcıları Listele |
Kuruluştaki tüm kullanıcıları alma (Microsoft Entra ID Kiracısı) |
| Üye Grupları Alma |
Bir kullanıcı için grup üyelikleri (üye) |
| Üye Lisans Ayrıntılarını Alma |
Grup üyesinin (kullanıcı) lisans ayrıntılarını alma |
Abone Olunan Sku'ları Listeleme
Kuruluşun abone olunan lisans planı SKU'larının ayrıntıları
Döndürülenler
| Name | Yol | Tür | Description |
|---|---|---|---|
|
Odata Bağlamı
|
@odata.context | string |
Odata.context bağlantısı. |
|
value
|
value | array of object |
value |
|
Yetenek Durumu
|
value.capabilityStatus | string |
SKU'nun Yetenek Durumu |
|
Tüketilen Birimler
|
value.consumedUnits | integer |
Zaten kaç SKU birimi kullanılıyor? |
|
Kimlik
|
value.id | string |
kimlik |
|
SKU Kimliği
|
value.skuId | string |
SKU'nun genel benzersiz tanımlayıcısı |
|
SKU Parça Numarası
|
value.skuPartNumber | string |
SKU'nun adı |
|
Şunun için geçerlidir:
|
value.appliesTo | string |
SKU kime uygulanır? |
|
Etkinleştirildi
|
value.prepaidUnits.enabled | integer |
Etkin birimler |
|
Askıya alındı
|
value.prepaidUnits.suspended | integer |
Askıya alınan birimler |
|
Uyarı
|
value.prepaidUnits.warning | integer |
Uyarıdaki birimler |
|
servicePlans
|
value.servicePlans | array of object |
servicePlans |
|
servicePlanId
|
value.servicePlans.servicePlanId | string |
servicePlanId |
|
servicePlanName
|
value.servicePlans.servicePlanName | string |
servicePlanName |
|
provisioningStatus
|
value.servicePlans.provisioningStatus | string |
provisioningStatus |
|
applyliTo
|
value.servicePlans.appliesTo | string |
applyliTo |
Doğrudan Grup Üyelerini Listeleme
Sayıyla bir grubun doğrudan üyelerini alma
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Microsoft Entra Id grubunun Nesne Kimliği
|
group-id | True | string |
Microsoft Entra Id grubunun Nesne Kimliği |
|
Filtre Ölçütü
|
$filter | string |
Filtre Ölçütü |
|
|
Veri noktası (sütun) seçimi
|
$select | string |
Alınacak sütunları seçme |
Döndürülenler
| Name | Yol | Tür | Description |
|---|---|---|---|
|
Odata Bağlamı
|
@odata.context | string |
Odata.context bağlantısı. |
|
Odata Sayısı
|
@odata.count | integer |
@odata.count |
|
value
|
value | array of object |
value |
|
Odata Türü
|
value.@odata.type | string |
@odata.type |
|
Görüntü adı
|
value.displayName | string |
Üyenin tam adı |
|
Kullanıcı Asıl Adı
|
value.userPrincipalName | string |
Üyenin kullanıcı asıl adı |
|
Kimlik
|
value.id | string |
Üyenin nesne kimliği |
|
İş unvanı
|
value.jobTitle | string |
iş unvanı |
|
Posta Takma Adı
|
value.mailNickname | string |
Üyenin e-posta takma adı |
|
Posta
|
value.mail | string |
Üyenin e-posta adresi |
|
İsim
|
value.givenName | string |
Üyenin adı |
|
Surname
|
value.surname | string |
Üyenin soyadı |
|
businessPhone'lar
|
value.businessPhones | array of string |
businessPhone'lar |
|
Cep Telefonu
|
value.mobilePhone | string |
cep telefonu |
|
Office Konumu
|
value.officeLocation | string |
officeLocation |
|
Tercih Edilen Dil
|
value.preferredLanguage | string |
Microsoft Entra Id'de yapılandırıldığı gibi tercih edilen dil. |
Grup Özelliklerini Alma
Microsoft Entra Id grubunun özelliklerini ve ilişkilerini alma
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Microsoft Entra Id grubunun Nesne Kimliği
|
group-id | True | string |
Microsoft Entra Id grubunun Nesne Kimliği |
Döndürülenler
| Name | Yol | Tür | Description |
|---|---|---|---|
|
Odata Bağlamı
|
@odata.context | string |
Odata.context bağlantısı. |
|
Kimlik
|
id | string |
Grubun nesne kimliği |
|
Silinen Tarih Saati
|
deletedDateTime | string |
Grubun silme tarih saati |
|
Classification
|
classification | string |
sınıflandırma |
|
Oluşturma Tarihi Saati
|
createdDateTime | string |
Grubun oluşturma tarih saati |
|
creationOptions
|
creationOptions | array of string |
Grubun seçenekleri oluşturuldu. |
|
Description
|
description | string |
açıklama |
|
Görüntü adı
|
displayName | string |
Grubun görünen adı |
|
Sona Erme Tarihi Saati
|
expirationDateTime | string |
Grubun son kullanma tarihi saati |
|
groupTypes
|
groupTypes | array of string |
Grubun grup türleri. |
|
Role Atanabilir
|
isAssignableToRole | string |
Bu gruba bir rol atanabilir mi? |
|
Posta
|
string |
Grubun e-posta adresi |
|
|
Posta Etkin
|
mailEnabled | boolean |
Grup e-postası etkin mi? |
|
Posta Takma Adı
|
mailNickname | string |
Grubun e-posta takma adı |
|
Üyelik Kuralı
|
membershipRule | string |
Üyelik değerlendirmesi için kullanılan kural. |
|
Üyelik Kuralı İşleme Durumu
|
membershipRuleProcessingState | string |
Üyelik değerlendirmesi için kullanılan kuralın işleme durumu. |
|
OnPremises Etki Alanı Adı
|
onPremisesDomainName | string |
Şirket içi dizinden eşitlenen dnsDomainName olarak da adlandırılan şirket içi etki alanıFQDN'sini içerir. |
|
OnPremises Last Sync Date Time
|
onPremisesLastSyncDateTime | string |
Kiracının şirket içi dizinle en son eşitlendiği saat ve tarih. |
|
OnPremises NetBios Adı
|
onPremisesNetBiosName | string |
Şirket içi sunucu için ağ hizmetinin adı. |
|
OnPremises Sam Hesap Adı
|
onPremisesSamAccountName | string |
Şirket içi dizin için Sam hesabı adı. |
|
OnPremises Güvenlik Tanımlayıcısı
|
onPremisesSecurityIdentifier | string |
Şirket içi güvenlik tanımlayıcısı. |
|
OnPremises Eşitleme Etkin
|
onPremisesSyncEnabled | boolean |
Şirket içi eşitleme grup için etkinleştirildiyse True. |
|
Tercih Edilen Veri Konumu
|
preferredDataLocation | string |
Grubun tercih edilen veri konumu. |
|
Tercih Edilen Dil
|
preferredLanguage | string |
Microsoft Entra Id'de yapılandırıldığı gibi tercih edilen dil. |
|
Proxy Adresleri
|
proxyAddresses | array of string |
Grubun proxy adresleri. |
|
Yenilenen Tarih Saat
|
renewedDateTime | string |
Grubun yenilenme tarihi. |
|
resourceBehaviorOptions
|
resourceBehaviorOptions | array of string |
Grubun kaynak davranışı seçenekleri. |
|
resourceProvisioningOptions
|
resourceProvisioningOptions | array of string |
Grubun kaynak sağlama seçenekleri. |
|
Güvenlik Etkin
|
securityEnabled | boolean |
Grubun güvenlik etkin olup olmadığını gösterir. |
|
Güvenlik Tanımlayıcısı
|
securityIdentifier | string |
Grubun güvenlik tanımlayıcısı. |
|
Theme
|
theme | string |
Microsoft Entra Id grubunun teması. |
|
Görünürlük
|
visibility | string |
Grubun görünürlüğü. |
|
onPremisesProvisioningErrors
|
onPremisesProvisioningErrors | array of string |
Grubun şirket içi sağlama hataları. |
Grupları Görünen Ad Arama ölçütüne göre listele
Grubun görünen adını arayarak grupları alma
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Görünen ada göre arama
|
$search | string |
Microsoft Entra Id grubunun görünen adında anahtar sözcükle arama |
Döndürülenler
| Name | Yol | Tür | Description |
|---|---|---|---|
|
Odata Bağlamı
|
@odata.context | string |
Odata.context bağlantısı. |
|
Grup Sayısı
|
@odata.count | integer |
@odata.count |
|
value
|
value | array of object |
value |
|
Kimlik
|
value.id | string |
Grubun nesne kimliği |
|
Silinen Tarih Saati
|
value.deletedDateTime | string |
Grup silme tarihi ve saati |
|
Classification
|
value.classification | string |
Grup sınıflandırması |
|
Oluşturma Tarihi Saati
|
value.createdDateTime | string |
Grup oluşturma tarihi ve saati |
|
creationOptions
|
value.creationOptions | array of |
Grubun seçenekleri oluşturuldu. |
|
Description
|
value.description | string |
Grubun açıklaması |
|
Görüntü adı
|
value.displayName | string |
Grubun görünen adı |
|
Sona Erme Tarihi Saati
|
value.expirationDateTime | string |
Grubun son kullanma tarihi saati |
|
groupTypes
|
value.groupTypes | array of string |
Grubun grup türleri. |
|
Role Atanabilir
|
value.isAssignableToRole | string |
Bu gruba bir rol atanabilir mi? |
|
Posta
|
value.mail | string |
Grubun e-posta adresi |
|
Posta Etkin
|
value.mailEnabled | boolean |
Grup e-postası etkin mi? |
|
Posta Takma Adı
|
value.mailNickname | string |
Grubun e-posta takma adı |
|
Üyelik Kuralı
|
value.membershipRule | string |
Üyelik değerlendirmesi için kullanılan kural. |
|
Üyelik Kuralı İşleme Durumu
|
value.membershipRuleProcessingState | string |
Üyelik değerlendirmesi için kullanılan kuralın işleme durumu. |
|
OnPremises Etki Alanı Adı
|
value.onPremisesDomainName | string |
Şirket içi dizinden eşitlenen dnsDomainName olarak da adlandırılan şirket içi etki alanıFQDN'sini içerir. |
|
OnPremises Last Sync Date Time
|
value.onPremisesLastSyncDateTime | string |
Kiracının şirket içi dizinle en son eşitlendiği saat ve tarih. |
|
OnPremises NetBios Adı
|
value.onPremisesNetBiosName | string |
Şirket içi sunucu için ağ hizmetinin adı. |
|
OnPremises Sam Hesap Adı
|
value.onPremisesSamAccountName | string |
Şirket içi dizin için Sam hesabı adı. |
|
OnPremises Güvenlik Tanımlayıcısı
|
value.onPremisesSecurityIdentifier | string |
Şirket içi güvenlik tanımlayıcısı. |
|
OnPremises Eşitleme Etkin
|
value.onPremisesSyncEnabled | boolean |
Şirket içi eşitleme grup için etkinleştirildiyse True. |
|
Tercih Edilen Veri Konumu
|
value.preferredDataLocation | string |
Grubun tercih edilen veri konumu. |
|
Tercih Edilen Dil
|
value.preferredLanguage | string |
Microsoft Entra Id'de yapılandırıldığı gibi tercih edilen dil. |
|
Proxy Adresleri
|
value.proxyAddresses | array of string |
Grubun proxy adresleri. |
|
Yenilenen Tarih Saat
|
value.renewedDateTime | string |
Grubun yenilenme tarihi. |
|
resourceBehaviorOptions
|
value.resourceBehaviorOptions | array of |
Grubun kaynak davranışı seçenekleri. |
|
resourceProvisioningOptions
|
value.resourceProvisioningOptions | array of string |
Grubun kaynak sağlama seçenekleri. |
|
Güvenlik Etkin
|
value.securityEnabled | boolean |
Grubun güvenlik etkin olup olmadığını gösterir. |
|
Güvenlik Tanımlayıcısı
|
value.securityIdentifier | string |
Grubun güvenlik tanımlayıcısı. |
|
Theme
|
value.theme | string |
Microsoft Entra Id grubunun teması. |
|
Görünürlük
|
value.visibility | string |
Grubun görünürlüğü. |
|
onPremisesProvisioningErrors
|
value.onPremisesProvisioningErrors | array of |
Grubun şirket içi sağlama hataları. |
Kullanıcıları Listele
Kuruluştaki tüm kullanıcıları alma (Microsoft Entra ID Kiracısı)
Döndürülenler
| Name | Yol | Tür | Description |
|---|---|---|---|
|
@odata.context
|
@odata.context | string |
Odata.context bağlantısı. |
|
value
|
value | array of object |
value |
|
businessPhone'lar
|
value.businessPhones | array of string |
businessPhone'lar |
|
Görüntü adı
|
value.displayName | string |
Kullanıcının tam adı |
|
İsim
|
value.givenName | string |
Kullanıcının adı |
|
İş unvanı
|
value.jobTitle | string |
Kullanıcının iş unvanı |
|
Posta
|
value.mail | string |
Kullanıcının e-posta adresi |
|
Cep Telefonu
|
value.mobilePhone | string |
Kullanıcının cep telefonu |
|
Office Konumu
|
value.officeLocation | string |
Kullanıcının ofis konumu |
|
Tercih Edilen Dil
|
value.preferredLanguage | string |
Kullanıcının tercih ettiği dil |
|
Surname
|
value.surname | string |
Kullanıcının soyadı |
|
Kullanıcı Asıl Adı
|
value.userPrincipalName | string |
Kullanıcının asıl adı |
|
Kimlik
|
value.id | string |
Kullanıcının nesne kimliği |
Üye Grupları Alma
Bir kullanıcı için grup üyelikleri (üye)
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Microsoft Entra Id üyesinin (kullanıcı) Nesne Kimliği
|
member-id | True | string |
Microsoft Entra Id üyesinin (kullanıcı) Nesne Kimliği |
|
Yalnızca Güvenlik Etkin (true/false)
|
securityEnabledOnly | True | boolean |
Yalnızca güvenlik özellikli grupları almak istiyor musunuz? |
Döndürülenler
| Name | Yol | Tür | Description |
|---|---|---|---|
|
Odata Bağlamı
|
@odata.context | string |
Odata.context bağlantısı. |
|
value
|
value | array of string |
value |
Üye Lisans Ayrıntılarını Alma
Grup üyesinin (kullanıcı) lisans ayrıntılarını alma
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Microsoft Entra Id üyesinin (kullanıcı) Nesne Kimliği
|
id | True | string |
Microsoft Entra Id üyesinin (kullanıcı) Nesne Kimliği |
|
Veri noktaları (sütunlar) seçimi
|
$select | string |
Veri noktaları (sütunlar) seçimi |
Döndürülenler
| Name | Yol | Tür | Description |
|---|---|---|---|
|
Odata Bağlamı
|
@odata.context | string |
Odata.context bağlantısı. |
|
value
|
value | array of object |
value |
|
Kimlik
|
value.id | string |
kimlik |
|
SKU Kimliği
|
value.skuId | string |
SKU'nun kimliği. |
|
SKU Parça Numarası
|
value.skuPartNumber | string |
SKU'nun adı |
|
servicePlans
|
value.servicePlans | array of object |
servicePlans |
|
servicePlanId
|
value.servicePlans.servicePlanId | string |
servicePlanId |
|
servicePlanName
|
value.servicePlans.servicePlanName | string |
servicePlanName |
|
provisioningStatus
|
value.servicePlans.provisioningStatus | string |
provisioningStatus |
|
applyliTo
|
value.servicePlans.appliesTo | string |
applyliTo |