Skip to main content

git_lab_groups

Creates, updates, deletes, gets or lists a git_lab_groups resource.

Overview

Namegit_lab_groups
TypeResource
Idazure.security.git_lab_groups

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
idstringFully qualified resource ID for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}.
namestringThe name of the resource.
fullyQualifiedFriendlyNamestringGets or sets the human readable fully-qualified name of the Group object. This contains the entire namespace hierarchy as seen on GitLab UI where namespaces are separated by the '/' character.
fullyQualifiedNamestringGets or sets the fully-qualified name of the Group object. This contains the entire namespace hierarchy where namespaces are separated by the '$' character.
onboardingStatestringDetails about resource onboarding status across all connectors. OnboardedByOtherConnector - this resource has already been onboarded to another connector. This is only applicable to top-level resources. Onboarded - this resource has already been onboarded by the specified connector. NotOnboarded - this resource has not been onboarded to any connector. NotApplicable - the onboarding state is not applicable to the current endpoint. Known values are: "NotApplicable", "OnboardedByOtherConnector", "Onboarded", and "NotOnboarded". (NotApplicable, OnboardedByOtherConnector, Onboarded, NotOnboarded)
provisioningStatestringThe provisioning state of the resource. Pending - Provisioning pending. Failed - Provisioning failed. Succeeded - Successful provisioning. Canceled - Provisioning canceled. PendingDeletion - Deletion pending. DeletionSuccess - Deletion successful. DeletionFailure - Deletion failure. Known values are: "Succeeded", "Failed", "Canceled", "Pending", "PendingDeletion", "DeletionSuccess", and "DeletionFailure". (Succeeded, Failed, Canceled, Pending, PendingDeletion, DeletionSuccess, DeletionFailure)
provisioningStatusMessagestringGets the resource status message.
provisioningStatusUpdateTimeUtcstring (date-time)Gets the time when resource was last checked.
systemDataobjectAzure Resource Manager metadata containing createdBy and modifiedBy information.
typestringThe type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts".
urlstringGets or sets the url of the GitLab Group.

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
getselectresource_group_name, security_connector_name, group_fq_name, subscription_idReturns a monitored GitLab Group resource for a given fully-qualified name. Returns a monitored GitLab Group resource for a given fully-qualified name.
listselectresource_group_name, security_connector_name, subscription_idReturns a list of GitLab groups onboarded to the connector. Returns a list of GitLab groups onboarded to the connector.
list_availableexecresource_group_name, security_connector_name, subscription_idReturns a list of all GitLab groups accessible by the user token consumed by the connector. Returns a list of all GitLab groups accessible by the user token consumed by the connector.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
group_fq_namestringRequired.
resource_group_namestringThe name of the resource group. The name is case insensitive. Required.
security_connector_namestringThe security connector name. Required.
subscription_idstring

SELECT examples

Returns a monitored GitLab Group resource for a given fully-qualified name. Returns a monitored GitLab Group resource for a given fully-qualified name.

SELECT
id,
name,
fullyQualifiedFriendlyName,
fullyQualifiedName,
onboardingState,
provisioningState,
provisioningStatusMessage,
provisioningStatusUpdateTimeUtc,
systemData,
type,
url
FROM azure.security.git_lab_groups
WHERE resource_group_name = '{{ resource_group_name }}' -- required
AND security_connector_name = '{{ security_connector_name }}' -- required
AND group_fq_name = '{{ group_fq_name }}' -- required
AND subscription_id = '{{ subscription_id }}' -- required
;

Lifecycle Methods

Returns a list of all GitLab groups accessible by the user token consumed by the connector. Returns a list of all GitLab groups accessible by the user token consumed by the connector.

EXEC azure.security.git_lab_groups.list_available 
@resource_group_name='{{ resource_group_name }}' --required,
@security_connector_name='{{ security_connector_name }}' --required,
@subscription_id='{{ subscription_id }}' --required
;