Container registries
Container registries is the Falcon Container registry-list collection
for this CID — ReadRegistryEntities then
ReadRegistryEntitiesByUUID, CreateRegistryEntities (SOURCE
CreateRegistryEntities, PEP 8 create_registry_entities),
DeleteRegistryEntities (SOURCE DeleteRegistryEntities, PEP 8
delete_registry_entities), and UpdateRegistryEntities (SOURCE
UpdateRegistryEntities, PEP 8 update_registry_entities). The
paths are GET /container-security/queries/registries/v1 and
GET /container-security/entities/registries/v1. The Create POST path
is POST /container-security/entities/registries/v1 (same path as GET
entities, method POST). The Delete path is
DELETE /container-security/entities/registries/v1 (same path as GET
entities, method DELETE; distinct from GET queries, GET/POST/PATCH
entities, DeleteImageDetails /entities/images/v1, Registry
credentials, and Kubernetes). The Update PATCH path is
PATCH /container-security/entities/registries/v1 (same path as GET
entities, method PATCH; distinct from GET queries, GET/POST/DELETE
entities, DeleteImageDetails /entities/images/v1, Registry
credentials, and Kubernetes). Image assessment policies / remaining cloud, remaining Kubernetes Protection, remaining Container
Images ops, remaining Container Vulnerabilities ops, and remaining
CSPM are not implemented (not yet). This is not Container images
(/container-security/combined/image-assessment/images/v1) and not
Container vulnerabilities
(/container-security/combined/vulnerabilities/v1). Registry credentials
is a separate collection:
Registry credentials. This is not
Kubernetes (/kubernetes-protection/…). This is not
the HelloService template sample (GET /api/hello).
This collection is not CrowdStrike production. It does not call Falcon cloud. It is not CrowdStrike Falcon Container cloud.
RPC field notes:
ContainerImagesService.
REST schemas: API reference. Container registries use query then
entities by ids, not FQL. POST create (/entities/registries/v1)
uses JSON body {type, url, user_defined_alias}. Extra unused keys
including credential, url_uniqueness_key, and parameters are
ignored; the clone does not persist credentials. Clone success is JSON
MSA 200 ContainerRegistry. Id DESIGN reg- + alias. Distinct from
GET queries, GET/POST/PATCH/DELETE entities, DeleteImageDetails,
Registry credentials, and Kubernetes. DELETE uses required query ids.
Extra unused keys are ignored. DELETE does not cascade images.
PATCH update (/entities/registries/v1) uses required query id and
JSON body {user_defined_alias}. Extra unused keys including
credential, state, and parameters are ignored; the clone does
not persist credentials. PATCH does not change type, url, or cid.
Clone PATCH success is JSON MSA 200 ContainerRegistry. Distinct
from GET queries, GET/POST/DELETE entities, DeleteImageDetails,
Registry credentials, and Kubernetes. Live curls must use
-X PATCH (bare -d POSTs onto create).
These curls use Host: crowdstrike-api.localhost against Compose
Traefik on :8088. If the hostname already resolves to Traefik, you can
omit the Host header and call http://crowdstrike-api.localhost instead.
Auth
Every call needs a console session or a Bearer token:
- Cookie
cs_consolefromCreateSession(POST /identity/entities/sessions/v1) Authorization: Bearerwithfalcon-container-image:read(GET) orfalcon-container-image:write(POST, DELETE, PATCH)
A session cookie bypasses OAuth scopes. Seed client cs-local-hosts
(hosts:read only) cannot list registries, create, delete, or update
(403). falcon-container-image:read can list registries and
cannot POST, DELETE, or PATCH (403). ReadRegistryEntities and
ReadRegistryEntitiesByUUID stay falcon-container-image:read. Unit
tests use a client named cs-local-cimg with
falcon-container-image:read; that client can list registries and
cannot POST, DELETE, or PATCH (403). Unit tests use a client
named cs-local-cimgw with falcon-container-image:write; that client
can POST, DELETE, and PATCH. It is not in the production seed.
There is no seeded production client with
falcon-container-image:read or falcon-container-image:write — use
the console cookie, or a client you created with that scope. Missing or
revoked token → 401.
HTTP paths
| Method | Path | Use |
|---|---|---|
GET | /container-security/queries/registries/v1 | Query ids. Query: limit, offset, sort. |
GET | /container-security/entities/registries/v1?ids= | Get registries for those ids. Empty ids → 400. |
POST | /container-security/entities/registries/v1 | Create a registry. RPC CreateRegistryEntities. SOURCE CreateRegistryEntities. PEP 8 create_registry_entities. Body JSON {type, url, user_defined_alias}. Distinct from GET queries, GET entities, PATCH update, DELETE, DeleteImageDetails, Registry credentials, and Kubernetes. Success 200 MSA ContainerRegistry. Extra unused keys ignored. Required type, url, user_defined_alias. Clone does not persist credential. Id reg- + alias. falcon-container-image:write. |
DELETE | /container-security/entities/registries/v1?ids= | Delete registries. RPC DeleteRegistryEntities. SOURCE DeleteRegistryEntities. PEP 8 delete_registry_entities. Query ids. Distinct from GET queries, GET/POST/PATCH entities, DeleteImageDetails, Registry credentials, and Kubernetes. Success 200 MSA ContainerRegistry. Extra unused keys ignored. Required ids. falcon-container-image:write. Does not cascade images. |
PATCH | /container-security/entities/registries/v1?id= | Update a registry alias. RPC UpdateRegistryEntities. SOURCE UpdateRegistryEntities. PEP 8 update_registry_entities. Query id. Body JSON {user_defined_alias}. Distinct from GET queries, GET/POST/DELETE entities, DeleteImageDetails, Registry credentials, and Kubernetes. Success 200 MSA ContainerRegistry. Extra unused keys ignored. Required query id + body user_defined_alias. Clone does not persist credential. Does not change type/url. falcon-container-image:write. Live curls must use -X PATCH. |
There is no filter. Query then pass the returned ids on the entities
path. limit and offset must be ≥ 0 else 400. Omitted limit
defaults to 100 (capped at 100). Default sort is id ascending.
Unknown ids are omitted from resources (empty list 200, not 404).
JSON is SOURCE snake_case: id, type, url, user_defined_alias,
cid.
POST create body JSON {type, url, user_defined_alias} on
/entities/registries/v1 (distinct from GET queries, GET entities
same path, PATCH update, DELETE, DeleteImageDetails, Registry
credentials, and Kubernetes).
Missing type → 400 type is required. Missing url → 400
url is required. Missing user_defined_alias → 400
user_defined_alias is required. Duplicate url → 400
url already exists. Duplicate user_defined_alias (or existing id)
→ 400 user_defined_alias already exists. Extra unused keys
including credential, url_uniqueness_key, and parameters are
ignored; the clone does not persist credentials. Clone success is
200 MSA ContainerRegistry (not SOURCE 201). POST
type=docker / url=quay.io / user_defined_alias=lab-quay returns
id reg-lab-quay. falcon-container-image:read on POST → 403.
cs-local-hosts on POST → 403. This is not GET queries,
not GET entities, not PATCH update, not DELETE, not
DeleteImageDetails, not Registry credentials, and not
Kubernetes.
DELETE query ids on /entities/registries/v1 (distinct from GET
queries, GET/POST/PATCH entities, DeleteImageDetails
/entities/images/v1, Registry credentials, and Kubernetes). Missing
ids → 400 ids is required. Unknown ids → 404. Extra
unused query keys are ignored. Clone success is 200 MSA
ContainerRegistry. DELETE ids=reg-lab-2 returns that row then
removes it. GET entities after DELETE ids=reg-lab-2 is empty;
ids=reg-lab-1 remains. DELETE does not cascade images.
falcon-container-image:read on DELETE → 403. cs-local-hosts on
DELETE → 403. This is not GET queries, not GET/POST/PATCH
entities, not DeleteImageDetails, not Registry credentials, and
not Kubernetes.
PATCH update query id and body {user_defined_alias} on
/entities/registries/v1 (distinct from GET queries, GET/POST/DELETE
entities, DeleteImageDetails /entities/images/v1, Registry
credentials, and Kubernetes). Missing id → 400 id is required.
Missing user_defined_alias → 400 user_defined_alias is required.
Unknown id → 404 unknown registry id. Duplicate
user_defined_alias (another row, e.g. lab-ghcr if reg-lab-2
exists) → 400 user_defined_alias already exists. Same id
updating to its current alias is OK. Extra unused keys including
credential, state, and parameters are ignored; the clone does
not persist credentials. PATCH does not change type, url, or cid.
Clone success is 200 MSA ContainerRegistry. PATCH id=reg-lab-1 /
user_defined_alias=lab-docker-b returns that row with alias
lab-docker-b; type stays docker and url stays docker.io. GET
entities after PATCH ids=reg-lab-1 matches. falcon-container-image:read
on PATCH → 403. cs-local-hosts on PATCH → 403. Live curls
must use -X PATCH. This is not GET queries, not
GET/POST/DELETE entities, not DeleteImageDetails, not Registry
credentials, and not Kubernetes.
This is not Container images, Container vulnerabilities, or the
HelloService template. Container images uses
/container-security/combined/image-assessment/images/v1:
Container images. Combined container vulnerabilities
uses /container-security/combined/vulnerabilities/v1:
Container vulnerabilities. Registry
credentials uses /container-security/entities/image-registry-credentials/v1:
Registry credentials. DeleteImageDetails uses
/container-security/entities/images/v1:
Container images. Image assessment policies / remaining cloud and other cloud collections are not implemented
(not yet).
Seed registries
id | type | url | user_defined_alias |
|---|---|---|---|
reg-lab-1 | docker | docker.io | lab-docker |
reg-lab-2 | docker | ghcr.io | lab-ghcr |
cid is cid-local-1. Query returns both ids. Entities
ids=reg-lab-1 returns that row. POST create with type=docker /
url=quay.io / user_defined_alias=lab-quay adds reg-lab-quay.
reg-lab-quay is not a seed. GET entities ids=reg-lab-quay
after POST matches that row. DELETE ids=reg-lab-2 removes that row.
GET entities after DELETE ids=reg-lab-2 is empty; ids=reg-lab-1
remains. DELETE does not cascade images. PATCH id=reg-lab-1 /
user_defined_alias=lab-docker-b updates that alias. GET entities
after PATCH ids=reg-lab-1 matches alias lab-docker-b; type and url
stay docker / docker.io. PATCH does not persist credential.
Session cookie
curl -sS -c cookies.txt -H 'Host: crowdstrike-api.localhost' \
-H 'Content-Type: application/json' \
-d '{"email":"[email protected]","password":"FalconLocal!1","cloud":"us-1"}' \
http://127.0.0.1:8088/identity/entities/sessions/v1
Query registries (cookie)
Query returns at least the two seed ids, including reg-lab-1:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/queries/registries/v1'
Get registries (cookie)
ids=reg-lab-1 returns that row:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/entities/registries/v1?ids=reg-lab-1'
Empty ids is 400:
curl -sS -o /dev/null -w '%{http_code}\n' \
-H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/entities/registries/v1'
No cookie and no Bearer is 401:
curl -sS -o /dev/null -w '%{http_code}\n' \
-H 'Host: crowdstrike-api.localhost' \
'http://127.0.0.1:8088/container-security/queries/registries/v1'
Create registry (cookie)
POST type=docker / url=quay.io / user_defined_alias=lab-quay on
/entities/registries/v1 returns that registry with id reg-lab-quay.
Success is 200 MSA ContainerRegistry. This is not GET queries,
not GET entities, not PATCH update, not DELETE, not
DeleteImageDetails, not Registry credentials, and not
Kubernetes. Extra unused keys including credential are ignored; the
clone does not persist credentials:
curl -sS -X POST -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
-H 'Content-Type: application/json' \
-d '{"type":"docker","url":"quay.io","user_defined_alias":"lab-quay","credential":"ignored"}' \
'http://127.0.0.1:8088/container-security/entities/registries/v1'
GET after POST matches that row:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/entities/registries/v1?ids=reg-lab-quay'
Duplicate url is 400:
curl -sS -o /dev/null -w '%{http_code}\n' \
-X POST -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
-H 'Content-Type: application/json' \
-d '{"type":"docker","url":"quay.io","user_defined_alias":"lab-quay-2"}' \
'http://127.0.0.1:8088/container-security/entities/registries/v1'
Duplicate user_defined_alias is 400:
curl -sS -o /dev/null -w '%{http_code}\n' \
-X POST -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
-H 'Content-Type: application/json' \
-d '{"type":"docker","url":"quay.io/lab","user_defined_alias":"lab-quay"}' \
'http://127.0.0.1:8088/container-security/entities/registries/v1'
Missing type is 400:
curl -sS -o /dev/null -w '%{http_code}\n' \
-X POST -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
-H 'Content-Type: application/json' \
-d '{"url":"quay.io","user_defined_alias":"lab-quay"}' \
'http://127.0.0.1:8088/container-security/entities/registries/v1'
Missing url is 400:
curl -sS -o /dev/null -w '%{http_code}\n' \
-X POST -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
-H 'Content-Type: application/json' \
-d '{"type":"docker","user_defined_alias":"lab-quay"}' \
'http://127.0.0.1:8088/container-security/entities/registries/v1'
Missing user_defined_alias is 400:
curl -sS -o /dev/null -w '%{http_code}\n' \
-X POST -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
-H 'Content-Type: application/json' \
-d '{"type":"docker","url":"quay.io"}' \
'http://127.0.0.1:8088/container-security/entities/registries/v1'
cs-local-hosts (hosts:read only) is 403 on POST:
TOKEN='<access_token from cs-local-hosts>'
curl -sS -o /dev/null -w '%{http_code}\n' \
-X POST -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
-H 'Content-Type: application/json' \
-d '{"type":"docker","url":"quay.io","user_defined_alias":"lab-quay"}' \
'http://127.0.0.1:8088/container-security/entities/registries/v1'
falcon-container-image:read (cs-local-cimg) is 403 on POST:
TOKEN='<access_token from cs-local-cimg>'
curl -sS -o /dev/null -w '%{http_code}\n' \
-X POST -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
-H 'Content-Type: application/json' \
-d '{"type":"docker","url":"quay.io","user_defined_alias":"lab-quay"}' \
'http://127.0.0.1:8088/container-security/entities/registries/v1'
No cookie and no Bearer is 401 on POST:
curl -sS -o /dev/null -w '%{http_code}\n' \
-X POST -H 'Host: crowdstrike-api.localhost' \
-H 'Content-Type: application/json' \
-d '{"type":"docker","url":"quay.io","user_defined_alias":"lab-quay"}' \
'http://127.0.0.1:8088/container-security/entities/registries/v1'
Image assessment policies / remaining cloud
and other cloud collections are not implemented (not yet). Container
images is a separate collection:
Container images. Combined container vulnerabilities
is a separate collection:
Container vulnerabilities. Registry
credentials is a separate collection:
Registry credentials. This is not
DeleteImageDetails (/entities/images/v1). This is not
Kubernetes. This is not the HelloService template (GET /api/hello).
Delete registry (cookie)
DELETE ids=reg-lab-2 on /entities/registries/v1 returns that
registry. Success is 200 MSA ContainerRegistry. GET entities after
DELETE ids=reg-lab-2 is empty; ids=reg-lab-1 remains. This is
not GET queries, not GET/POST/PATCH entities, not
DeleteImageDetails, not Registry credentials, and not
Kubernetes. Extra unused query keys including foo are ignored. DELETE
does not cascade images:
curl -sS -X DELETE -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/entities/registries/v1?ids=reg-lab-2&foo=bar'
GET entities after DELETE ids=reg-lab-2 is empty:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/entities/registries/v1?ids=reg-lab-2'
GET entities ids=reg-lab-1 still present:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/entities/registries/v1?ids=reg-lab-1'
Missing ids is 400:
curl -sS -o /dev/null -w '%{http_code}\n' \
-X DELETE -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/entities/registries/v1'
Unknown ids is 404:
curl -sS -o /dev/null -w '%{http_code}\n' \
-X DELETE -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/entities/registries/v1?ids=reg-missing'
cs-local-hosts (hosts:read only) is 403 on DELETE:
TOKEN='<access_token from cs-local-hosts>'
curl -sS -o /dev/null -w '%{http_code}\n' \
-X DELETE -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
'http://127.0.0.1:8088/container-security/entities/registries/v1?ids=reg-lab-2'
falcon-container-image:read (cs-local-cimg) is 403 on DELETE:
TOKEN='<access_token from cs-local-cimg>'
curl -sS -o /dev/null -w '%{http_code}\n' \
-X DELETE -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
'http://127.0.0.1:8088/container-security/entities/registries/v1?ids=reg-lab-2'
No cookie and no Bearer is 401 on DELETE:
curl -sS -o /dev/null -w '%{http_code}\n' \
-X DELETE -H 'Host: crowdstrike-api.localhost' \
'http://127.0.0.1:8088/container-security/entities/registries/v1?ids=reg-lab-2'
Image assessment policies / remaining cloud
and other cloud collections are not implemented (not yet). Container
images is a separate collection:
Container images. Combined container vulnerabilities
is a separate collection:
Container vulnerabilities. Registry
credentials is a separate collection:
Registry credentials. This is not
DeleteImageDetails (/entities/images/v1). This is not
Kubernetes. This is not the HelloService template (GET /api/hello).
Update registry (cookie)
PATCH id=reg-lab-1 / user_defined_alias=lab-docker-b on
/entities/registries/v1 returns that registry with alias
lab-docker-b. Success is 200 MSA ContainerRegistry. GET entities
after PATCH ids=reg-lab-1 matches. Type stays docker and url stays
docker.io. This is not GET queries, not GET/POST/DELETE
entities, not DeleteImageDetails, not Registry credentials, and
not Kubernetes. Required query id + body user_defined_alias.
Extra unused keys including credential, state, and parameters
are ignored; the clone does not persist credentials. PATCH does not
change type, url, or cid. Live curls must use -X PATCH (bare
-d POSTs onto create):
curl -sS -X PATCH -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
-H 'Content-Type: application/json' \
-d '{"user_defined_alias":"lab-docker-b","credential":"ignored","state":"ignored","parameters":"ignored"}' \
'http://127.0.0.1:8088/container-security/entities/registries/v1?id=reg-lab-1'
GET entities after PATCH matches alias lab-docker-b:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/entities/registries/v1?ids=reg-lab-1'
Missing id is 400:
curl -sS -o /dev/null -w '%{http_code}\n' \
-X PATCH -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
-H 'Content-Type: application/json' \
-d '{"user_defined_alias":"lab-docker-b"}' \
'http://127.0.0.1:8088/container-security/entities/registries/v1'
Missing user_defined_alias is 400:
curl -sS -o /dev/null -w '%{http_code}\n' \
-X PATCH -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
-H 'Content-Type: application/json' \
-d '{}' \
'http://127.0.0.1:8088/container-security/entities/registries/v1?id=reg-lab-1'
Unknown id is 404:
curl -sS -o /dev/null -w '%{http_code}\n' \
-X PATCH -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
-H 'Content-Type: application/json' \
-d '{"user_defined_alias":"lab-docker-b"}' \
'http://127.0.0.1:8088/container-security/entities/registries/v1?id=reg-missing'
Duplicate user_defined_alias (lab-ghcr if reg-lab-2 exists) is
400:
curl -sS -o /dev/null -w '%{http_code}\n' \
-X PATCH -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
-H 'Content-Type: application/json' \
-d '{"user_defined_alias":"lab-ghcr"}' \
'http://127.0.0.1:8088/container-security/entities/registries/v1?id=reg-lab-1'
cs-local-hosts (hosts:read only) is 403 on PATCH:
TOKEN='<access_token from cs-local-hosts>'
curl -sS -o /dev/null -w '%{http_code}\n' \
-X PATCH -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
-H 'Content-Type: application/json' \
-d '{"user_defined_alias":"lab-docker-b"}' \
'http://127.0.0.1:8088/container-security/entities/registries/v1?id=reg-lab-1'
falcon-container-image:read (cs-local-cimg) is 403 on PATCH:
TOKEN='<access_token from cs-local-cimg>'
curl -sS -o /dev/null -w '%{http_code}\n' \
-X PATCH -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
-H 'Content-Type: application/json' \
-d '{"user_defined_alias":"lab-docker-b"}' \
'http://127.0.0.1:8088/container-security/entities/registries/v1?id=reg-lab-1'
No cookie and no Bearer is 401 on PATCH:
curl -sS -o /dev/null -w '%{http_code}\n' \
-X PATCH -H 'Host: crowdstrike-api.localhost' \
-H 'Content-Type: application/json' \
-d '{"user_defined_alias":"lab-docker-b"}' \
'http://127.0.0.1:8088/container-security/entities/registries/v1?id=reg-lab-1'
Image assessment policies / remaining cloud
and other cloud collections are not implemented (not yet). Container
images is a separate collection:
Container images. Combined container vulnerabilities
is a separate collection:
Container vulnerabilities. Registry
credentials is a separate collection:
Registry credentials. This is not
DeleteImageDetails (/entities/images/v1). This is not
Kubernetes. This is not the HelloService template (GET /api/hello).
Query (Bearer)
TOKEN='<access_token from a client with falcon-container-image:read>'
curl -sS -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
'http://127.0.0.1:8088/container-security/queries/registries/v1'
falcon-container-image:read → 200 (including unit-test client
cs-local-cimg). A token without that scope (including hosts:read
only, e.g. cs-local-hosts) → 403. Missing or revoked token →
401. ReadRegistryEntities stays falcon-container-image:read.
Create (Bearer)
TOKEN='<access_token from a client with falcon-container-image:write>'
curl -sS -X POST -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
-H 'Content-Type: application/json' \
-d '{"type":"docker","url":"quay.io","user_defined_alias":"lab-quay"}' \
'http://127.0.0.1:8088/container-security/entities/registries/v1'
falcon-container-image:write → 200 on POST (including unit-test
client cs-local-cimgw). A token without that scope (including
hosts:read only, e.g. cs-local-hosts, or
falcon-container-image:read, e.g. cs-local-cimg) → 403. Missing
or revoked token → 401. There is no seeded production client with
falcon-container-image:write — use the console cookie, or a client
you created with that scope. CreateRegistryEntities stays
falcon-container-image:write. PEP 8 create_registry_entities. Distinct
from GET queries, GET entities, PATCH update, DELETE, DeleteImageDetails,
Registry credentials, and Kubernetes.
Delete (Bearer)
TOKEN='<access_token from a client with falcon-container-image:write>'
curl -sS -X DELETE -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
'http://127.0.0.1:8088/container-security/entities/registries/v1?ids=reg-lab-2'
falcon-container-image:write → 200 on DELETE (including unit-test
client cs-local-cimgw). A token without that scope (including
hosts:read only, e.g. cs-local-hosts, or
falcon-container-image:read, e.g. cs-local-cimg) → 403. Missing
or revoked token → 401. There is no seeded production client with
falcon-container-image:write — use the console cookie, or a client
you created with that scope. DeleteRegistryEntities stays
falcon-container-image:write. PEP 8 delete_registry_entities. Distinct
from GET queries, GET/POST/PATCH entities, DeleteImageDetails, Registry
credentials, and Kubernetes. DELETE does not cascade images.
Update (Bearer)
TOKEN='<access_token from a client with falcon-container-image:write>'
curl -sS -X PATCH -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
-H 'Content-Type: application/json' \
-d '{"user_defined_alias":"lab-docker-b"}' \
'http://127.0.0.1:8088/container-security/entities/registries/v1?id=reg-lab-1'
falcon-container-image:write → 200 on PATCH (including unit-test
client cs-local-cimgw). A token without that scope (including
hosts:read only, e.g. cs-local-hosts, or
falcon-container-image:read, e.g. cs-local-cimg) → 403. Missing
or revoked token → 401. There is no seeded production client with
falcon-container-image:write — use the console cookie, or a client
you created with that scope. UpdateRegistryEntities stays
falcon-container-image:write. SOURCE UpdateRegistryEntities. PEP 8
update_registry_entities. Distinct from GET queries, GET/POST/DELETE
entities, DeleteImageDetails, Registry credentials, and Kubernetes.
Required query id + body user_defined_alias. Extra unused keys
ignored. The clone does not persist credential. PATCH does not
change type or url. Live curls must use -X PATCH. Image assessment policies / remaining cloud and other cloud collections are
not implemented (not yet).
OAuth2 mint/revoke: OAuth2. Accessible scopes: API clients.