Git Lab Subgroups - List

參考

服務:: Defender for Cloud

API 版本:: 2024-05-15-preview

取得已上線至連接器之指定 GitLab 群組的巢狀子群組。

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/securityConnectors/{securityConnectorName}/devops/default/gitLabGroups/{groupFQName}/listSubgroups?api-version=2024-05-15-preview

URI 參數

名稱	位於	必要	類型	Description
groupFQName	path	True	string	GitLab 群組完整名稱。
resourceGroupName	path	True	string	資源群組的名稱。名稱不區分大小寫。
securityConnectorName	path	True	string	安全性連接器名稱。
subscriptionId	path	True	string	目標訂用帳戶的標識碼。
api-version	query	True	string	要用於這項作業的 API 版本。

回應

名稱	類型	Description
200 OK	GitLabGroupListResponse	提供子群組的 GitLab 群組詳細數據清單
Other Status Codes	ErrorResponse	描述作業失敗原因的錯誤回應。

安全性

azure_auth

Azure Active Directory OAuth2 Flow

類型: oauth2
Flow: implicit
授權 URL: https://login.microsoftonline.com/common/oauth2/authorize

範圍

名稱	Description
user_impersonation	模擬您的用戶帳戶

範例

List_GitLabSubgroups

POST https://management.azure.com/subscriptions/0806e1cd-cfda-4ff8-b99c-2b0af42cffd3/resourceGroups/myRg/providers/Microsoft.Security/securityConnectors/mySecurityConnectorName/devops/default/gitLabGroups/myGitLabGroup/listSubgroups?api-version=2024-05-15-preview


/**
 * Samples for GitLabSubgroups List.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/security/resource-manager/Microsoft.Security/preview/2024-05-15-preview/examples/
     * SecurityConnectorsDevOps/ListGitLabSubgroups_example.json
     */
    /**
     * Sample code: List_GitLabSubgroups.
     * 
     * @param manager Entry point to SecurityManager.
     */
    public static void listGitLabSubgroups(com.azure.resourcemanager.security.SecurityManager manager) {
        manager.gitLabSubgroups().listWithResponse("myRg", "mySecurityConnectorName", "myGitLabGroup",
            com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

範例回覆

狀態碼:: 200

{
  "value": [
    {
      "properties": {
        "fullyQualifiedName": "myGitLabGroup$mySubGroup",
        "url": "https://gitlab.example.com/myGitLabGroup/mySubGroup",
        "onboardingState": "Onboarded",
        "provisioningState": "Succeeded"
      },
      "id": "/subscriptions/0806e1cd-cfda-4ff8-b99c-2b0af42cffd3/resourceGroups/myRg/providers/Microsoft.Security/securityConnectors/mySecurityConnectorName/devops/default/gitLabGroups/myGitLabGroup$mySubGroup",
      "name": "myGitLabGroup$mySubGroup",
      "type": "Microsoft.Security/securityConnectors/devops/gitLabGroups"
    }
  ]
}

定義

名稱	Description
createdByType	建立資源的身分識別類型。
DevOpsProvisioningState	資源的布建狀態。擱置 - 布建擱置中。失敗 - 布建失敗。成功 - 布建成功。已取消 - 已取消布建。 PendingDeletion - 刪除擱置中。 DeletionSuccess - 刪除成功。 DeletionFailure - 刪除失敗。
ErrorAdditionalInfo	資源管理錯誤其他資訊。
ErrorDetail	錯誤詳細數據。
ErrorResponse	錯誤回應
GitLabGroup	GitLab 群組資源。
GitLabGroupListResponse	支援分頁的 RP 資源清單。
GitLabGroupProperties	GitLab 群組屬性。
OnboardingState	所有連接器的資源上線狀態詳細數據。 OnboardedByOtherConnector - 此資源已上線至另一個連接器。這隻適用於最上層資源。上線 - 此資源已由指定的連接器上線。 NotOnboarded - 此資源尚未上線至任何連接器。 NotApplicable - 上線狀態不適用於目前的端點。
systemData	與建立和上次修改資源相關的元數據。

createdByType

建立資源的身分識別類型。

名稱	類型	Description
Application	string
Key	string
ManagedIdentity	string
User	string

DevOpsProvisioningState

資源的布建狀態。

擱置 - 布建擱置中。失敗 - 布建失敗。成功 - 布建成功。已取消 - 已取消布建。 PendingDeletion - 刪除擱置中。 DeletionSuccess - 刪除成功。 DeletionFailure - 刪除失敗。

名稱	類型	Description
Canceled	string
DeletionFailure	string
DeletionSuccess	string
Failed	string
Pending	string
PendingDeletion	string
Succeeded	string

ErrorAdditionalInfo

資源管理錯誤其他資訊。

名稱	類型	Description
info	object	其他資訊。
type	string	其他信息類型。

ErrorDetail

錯誤詳細數據。

名稱	類型	Description
additionalInfo	ErrorAdditionalInfo[]	錯誤其他資訊。
code	string	錯誤碼。
details	ErrorDetail[]	錯誤詳細數據。
message	string	錯誤訊息。
target	string	錯誤目標。

ErrorResponse

錯誤回應

名稱	類型	Description
error	ErrorDetail	error 物件。

GitLabGroup

GitLab 群組資源。

名稱	類型	Description
id	string	資源的完整資源標識碼。例如 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	資源的名稱
properties	GitLabGroupProperties	GitLab 群組屬性。
systemData	systemData	與建立和上次修改資源相關的元數據。
type	string	資源的型別。例如“Microsoft.Compute/virtualMachines” 或 “Microsoft.Storage/storageAccounts”

GitLabGroupListResponse

支援分頁的 RP 資源清單。

名稱	類型	Description
nextLink	string	取得或設定下一個連結，以捲動結果。
value	GitLabGroup[]	取得或設定資源清單。

GitLabGroupProperties

GitLab 群組屬性。

名稱	類型	Description
fullyQualifiedFriendlyName	string	取得或設定 Group 物件的人類可讀取完整名稱。這包含 GitLab UI 上所見的整個命名空間階層，其中命名空間是以『/』字元分隔。
fullyQualifiedName	string	取得或設定 Group 物件的完整名稱。這包含整個命名空間階層，其中命名空間是以『$』字元分隔。
onboardingState	OnboardingState	所有連接器的資源上線狀態詳細數據。 OnboardedByOtherConnector - 此資源已上線至另一個連接器。這隻適用於最上層資源。上線 - 此資源已由指定的連接器上線。 NotOnboarded - 此資源尚未上線至任何連接器。 NotApplicable - 上線狀態不適用於目前的端點。
provisioningState	DevOpsProvisioningState	資源的布建狀態。擱置 - 布建擱置中。失敗 - 布建失敗。成功 - 布建成功。已取消 - 已取消布建。 PendingDeletion - 刪除擱置中。 DeletionSuccess - 刪除成功。 DeletionFailure - 刪除失敗。
provisioningStatusMessage	string	取得資源狀態消息。
provisioningStatusUpdateTimeUtc	string	取得上次檢查資源的時間。
url	string	取得或設定 GitLab 群組的 URL。

OnboardingState

所有連接器的資源上線狀態詳細數據。

OnboardedByOtherConnector - 此資源已上線至另一個連接器。這隻適用於最上層資源。上線 - 此資源已由指定的連接器上線。 NotOnboarded - 此資源尚未上線至任何連接器。 NotApplicable - 上線狀態不適用於目前的端點。

名稱	類型	Description
NotApplicable	string
NotOnboarded	string
Onboarded	string
OnboardedByOtherConnector	string

systemData

與建立和上次修改資源相關的元數據。

名稱	類型	Description
createdAt	string	資源建立的時間戳（UTC）。
createdBy	string	建立資源的身分識別。
createdByType	createdByType	建立資源的身分識別類型。
lastModifiedAt	string	上次修改的資源時間戳（UTC）
lastModifiedBy	string	上次修改資源的身分識別。
lastModifiedByType	createdByType	上次修改資源的身分識別類型。

共用方式為